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Selenium 是 一 个 主要 用 于 Web 应 用 程序 自动 化 
测试 的 工具 集合 ， 在 行业 内 已 经 得 到 广泛 的 应 用 。 
本 书 介 绍 了 如 何 用 Python 语言 调用 Selenium 
WebDriver 接 口 进行 目 动 化 测试 。 主 要 内 容 为 : 基 
于 Python 的 Selenium WebDriver 入 门 知 识 、 第 一 个 
Selenium Python 脚本 、 使 用 unittest 编写 单元 测试 、 
生成 HTML 格 式 的 测试 报告 、 元 系 定 位 、Selenium 
Python API 介绍 、 元 素 等 得 机 制 、 跨 浏览 器 测试 、 
移动 端 测试 、 编 写 一 个 ij0S 测 斌 脚本、 编写 一 个 
Android 测 试 脚本 、Page Object 与 数据 驱动 测试 、 
Selenium WebDriver 的 高 级 特性 、 第 三 方 工具 与 框 
染 集成 等 核心 技术 。 




















本 书 适合 任何 软件 测试 人 员 阅 读 ， 也 适合 作为 


大 专 院 校 师 生 的 学 习 用 书 和 培训 学 校 的 教材 。 


推 存 序 








认识 能 志 男 是 在 中 国 质 量 大 会 BQConf 的 活动 
上 上 ， 交 谈 间 很 快 就 被 志 男 对 于 测试 领域 的 见解 和 趋 
势 展 望 所 折服 ， 而 这 不 仅仅 是 因为 他 有 丰富 的 测试 
经 验 ， 而 且 还 因为 他 作为 测试 久 的 联合 创始 人 ， 对 
国内 外 测试 行业 有 深入 的 了 解密 不 可 分 。 本 书 正 是 
—^MBE. 
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了 ， 但 是 我 们 很 难 在 目 动 化 测试 领域 招聘 到 经 验 丰 
齐 的 工程 师 ， 这 说 明 上 自动 化 测试 并 没有 成 为 国内 测 
试 领域 的 主流 。 





是 因为 测试 人 员 不 够 努力 导致 的 吗 ? 我 并 不 这 
么 认为 。 





很 多 公司 对 于 测试 的 投入 是 希望 知道 产品 有 多 
少 缺 陷 、 能 否 按 时 上 线 ， 所 以 相应 的 测试 人 员 的 工 
作 都 聚焦 于 如 何 高 效 地 编写 和 执行 测试 用 例 ， 而 目 
动 化 测试 并 不 是 第 一 选择 。 因 为 在 上 线 压 力 巨 大 的 
情况 下 ， 如 果 不 能 评估 出 上 自动 化 测试 的 投入 产 出 
比 ， 很 难 让 项 目 经 理 在 自动 化 测试 上 进行 投入 。 所 
以 倘 厂 有 实践 目 动 化 测试 的 想法 ， 往 往 需 要 测试 人 
员 付出 目 己 的 时 间 来 熟悉 框架 、 编 写 和 维护 目 动 化 
测试 。 而 如 果 不 是 事先 对 测试 框架 有 了 比较 深入 的 
认识 ， 依 徘 目 喘 自 友 进行 目 动 化 测试 ， 并 不 会 市 来 
效率 的 明显 提升 。 这 样 不 仅 会 让 项 目 经 理 失 去 信 
心 ， 人 恐怕 测试 人 员 目 己 也 心 存 疑虑 了 。 























如 琳 单 从 技术 上 考虑 ， 完 苋 是 什么 阻碍 看 测试 
人 员 广 泛 使 用 目 动 化 测试 呢 ? 首先 ， 如 朱 没 有 一 个 
通用 的 测试 框 杂 ， 那 么 每 做 一 个 项 目 ， 测 试 人 员 束 
fi 2] — EU] LE. / NEAR, K WFA ASA it 
了 。 在 工期 很 案 的 情况 下 更 是 如 此 。 其 次 ， 目 动 化 





测试 的 编写 实际 上 有 是 进行 编码 ， 如 条 使 用 Java 和 C# 
这 些 编程 语言 编写 上 自动 化 测试 ， 由 于 测试 人 员 很 难 
全 面 掌握 这 些 语 言 的 开发 技巧 ， 容 易 导 致 编写 出 的 
自动 化 测试 代码 比 产 品 代码 出 现 更 多 的 缺陷 。 





本 书 直 击 这 两 方面 ， 为 测试 人 员 解 除了 后 顾 之 
ME o 





(1) Selenium WebDriver 作 为 业界 通用 的 测试 
框架 ， 不 仪 是 Web 测 试 的 标准 ， 在 移动 测试 领域 也 
是 奔 层 的 核心 驱动 框架 。 所 以 掌握 了 Selenium 
WebDriver， 可 以 让 我 们 在 为 Web 产 品 和 移动 产品 
编写 自动 化 测试 时 游 刀 有 余 。 





(2) Python 作 为 动态 语言 ， 人 简化 了 严格 的 编 
程 语 法 ， 使 测试 人 员 更 容易 掌握 。 同 时 Python 也 所 
供 了 丰富 的 API 和 扩展 ， 测 试 人 员 可 以 很 便利 地 调 
用 或 者 集成 其 他 语言 编写 的 程序 和 类 库 ， 提 高 编写 
目 动 化 测试 的 效率 。 








本 书 在 讲述 自动 化 测试 编写 的 同时 ， 结 合 业界 
主流 的 自动 化 测试 开发 模式 ， 向 读者 介绍 了 多 种 测 
试 相 关 知识 “如 BDD 和 持续 集成 ) 。 非 常 推荐 对 测 
试 有 激情 ， 希 望 快速 提升 自动 化 测试 能 力 的 朋友 阅 
读本 书 ， 
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现任 ThoughtWorks 中 国 区 QA Lead 


译 洗 序 


起 初 接 到 本 书 的 翻译 邀约 时 ， 内 心 还 是 有 一 些 
困惑 的 。 针 对 软件 测试 行业 ， 特 别 是 基于 Web 目 动 
化 测试 领域 ，Selenium 已 经 是 广泛 使 用 的 工具 之 一 
了 ， 而 且 己 被 诸多 训 试 同行 认可 并 使 用 。 为 此 ， 我 
们 碍 疝 了 国内 大量 相关 书籍 或 文章 ， 及 现 当前 
Selenium 的 初学 门槛 其 实 并 不 局 ， 训 试 工程 师 具 备 
有 功能 测试 经 验 ， 加 之 对 Web 前 问 扩 术 的 一 定 程 度 
的 理解 ， 外 加 较 熟 练 地 向 握 一 门 脚本 语言 ， 经 过 一 
Bont lA UA FERK, eB Bese AS Dy H AY oli 
任务 。 不 过 与 此 同时 ， 我 们 也 友 现 很 多 初学 者 过 到 
的 诸多 团 惑 ， 叉 或 者 在 深入 学 习 过 程 中 难以 克服 的 





行业 内 ， 能 系统 性 介绍 WebDriver 原 理 、 多 类 


型 Server 运 行 方式 、 单 元 测试 以 及 如 何 使 用 Python 
调用 Selenium WebDriver 接 口 的 具体 实例 的 材料 相 
对 零散 。 直 到 《Fearning Selenium Testing Tools with 
Python》 中 文 版 的 出 版 ， 使 得 我 们 有 机 会 较为 全 
面 ， 并 且 系统 性 地 学 习 用 单一 脚本 语言 开 友 Web 目 
动 化 测试 的 具体 实践 ， 作 者 独特 的 创作 逻辑 ， 使 得 
本 书 前 后 实例 相互 对 照 ， 并 且 痢 尾 呼 应 。 既 诠释 原 
理 ， 叉 能 使 读者 进入 实战 ， 还 有 “干货 ” 满 满 的 “ 提 
醒 与 备注 ”"， 是 一 本 不 可 多 得 的 目 动 化 测试 指导 

书 。 这 也 是 我 们 诺 埋 这 本 书 最 重要 的 原因 了 。 














本 书 的 作者 Unmesh Gundecha 4 th AF E f] 
建 目 动 化 测试 解决 方案 的 经 验 。 主 导 开 发 过 大 量 疝 
业 或 开源 的 自动 化 测试 工具 。 曾 供职 微软 。 在 2012 
年 编著 过 《Selenium Testing Tools Cookbook) 一 
P, MADH: 在 2015 年 下 半年 又 更 新 发布 了 第 二 
版 。 作 者 文笔 犀利 ， 逐 辑 之 间 环 环 相 扣 ， 语 言 计 
W, WEEE. 














多 年 的 技术 文章 翻译 经 验 ， 使 我 们 清晰 地 认识 
到 ， 倘 大 停留 在 专业 翻译 层面 ， 想 必 本 书 的 可 读 
性 ， 以 及 作者 的 诺 多 表述 ， 都 难以 顺利 地 传递 给 中 
VZ. MARS REGI RAPERA) ， 多 次 调 
HEERE. FATES ab ee, BTR fM 
车 脉络 ”组 织 分 工 。 由 专业 词汇 翻译 ， 到 统一 关键 
WO, BSE), METAL. 诸如 此 类 的 
一 些 做 法 ， 都 是 为 了 保证 我 们 的 译 蓝 质量 更 加 符合 
测试 同行 的 阅读 习惯 ， 便 于 学 习 与 加 深 印象 。 



































好 在 翻译 过 程 中 ， 与 能 志 男 相互 吾 励 ， 包 括 审 
核 团 队 不 厌 其 烦 的 讨论 、PK、 一 起 揣摩 作者 意图 。 
RAWAL. A. HAL Ala, tba aye 
译 著 得 以 完成 。 特 别 感谢 参与 翻译 工作 的 张 有 欣欣 、 
谢 满 彬 、 谢 柳 娜 。 感 谢 测 试 寅 网 译文 团队 的 多 次 审 


校 。 

















翻译 列 人 的 图 书 ， 好 似 在 反 和 名， 再 精彩 也 是 在 


讲 别 人 的 故事 。 期 待 有 一 天 ， 有 机 会 能 够 讲 讲 我 们 
自己 的 故事 给 广大 同行 。 由 于 译 者 的 水 平 有 限 ， 难 
ARA MEMM. HARALA, KWE, jt 
联系 邮箱 zhangtao@ptpress.com.cn。 
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在 互联 网 行业 迅速 友 展 的 今天 ， 编 写 目 动 化 脚 
本 的 技能 ， 已 经 逐渐 成 为 Web 测试 人 员 的 标 配 。 


Python 作为 备 受 测试 人 员 青 睐 的 语言 之 一 ， 非 
苗 适 合 处 理 日 第 工作 中 的 数据 和 文本 问题 。 


Selenium 更 是 UI 目 动 化 测试 的 利 右 ， 但 要 迅 
速 掌握 并 熟练 运用 到 项 目 中 ， 绝 非 易 事 。 


本 书 围绕 Selenium 的 使 用 展开 ， 编 排 有 序 ， 
BRA, HATRA UI 自动 化 测试 经 验 的 读者 ， 
将 起 到 事半功倍 的 效 末 。 


Ping++ 质量 负 贡 人 RPS 





Unmesh Gundecha 编 车 的 《Selenium Testing 


Tools Cookbook) , *¢#k“Selenium3zi%”, ÆR- H 
He fe 2n | i WebDrivert) a Ws8, Are Rie 
一 致 未 被 翻译 成 中 文 版 本 出 版 。 





该 书 作为 “这 谱 ”的 Python 姊妹 扁 ， 秉 承 了 “这 
谱 ” 的 内 容 详 实 ， 案 例 丰 富 ， 行 文 流畅 等 特点 ， 是 
一 本 WebDriver 入 门 的 绝 佳 教材 。 








， 浙 江 大 学 硕士 ， 具 有 10 年 软件 测 
"mM er ERAT IM 

ITSM、PLM 软 件 研 发 企业 ， 现 于 某 金 融 行业 核心 
机 构 IT 规划 部 门 担任 项 目 管理 工作 。 业 余 时 间 喜 欢 
园艺 。《 精 通 自动 化 测试 框架 设计 》 一 书 的 作者 。 
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Unmesh Gundecha 拥 有 计算 机 软件 贷 士 学 位 ， 
在 软件 开 友 与 测试 领域 有 着 12 年 的 工作 经 验 。 无 论 
是 在 应 对 业界 标准 ， 还 是 定制 需求 下 ， 他 都 有 着 丰 
是 的 构建 目 动 化 测试 解决 方案 的 经 验 。 与 此 同时 ， 
他 还 主导 开发 了 大 量 商 业 或 开源 的 目 动 化 测试 工 
R. 


ZN 




















他 曾 供职 于 微软 公司 ， 从 事 开 有 发 有 关 的 工作 。 
目前 在 印度 的 一 家 跨国 企业 从 事 测 试 架 构 师 工作 ， 
在 Ruby、Java、iOS、Android 和 PHP 的 项 目 中 有 着 
极 丰 是 的 开发 与 测试 经 验 。 





作者 语 


另外 ， 本 书 能 顺利 编写 完成 ， 离 不 开 很 多 技术 
同行 的 帮助 与 审阅 ， 感 谢 他 们 花 颖 了 大 量 的 时 间 为 
本 书 提供 了 非常 有 价值 的 反馈。 


感谢 各 位 专家 、 同 事 和 朋友 ， 特 别 是 Yuri 
Weinstein 给 予 我 很 多 帮助 与 或 励 。 


Adil Imroz 是 一 位 Python 的 狂热 爱好 者 ， 长 期 
专注 在 测试 开发 与 移动 端 自动 化 领域 。 峭 尚 开 源 与 
敏捷 模式 。 朵 上 暇 时 ， 爱 好 单车 、 读 书 、 睡 觉 。 他 党 
得 这 些 都 可 以 为 他 开拓 眼界 。 





Dr. Philip Polstra〈 熟 悉 他 的 人 都 称呼 他 Dr. 
Phil) ， 国 际 知名 黑客 。 他 的 作品 曾 在 许多 国际 的 
专题 会 议 (包括 DEFCON、Black Hat, 44CON, 
Maker Faire 等 ) 上 提 及 ， 发 表 过 大 量 的 论文 ， 是 这 
一 领域 公认 的 专家 。 





Dr. Polstra 作 为 布鲁斯 伯 格 大 学 的 副教授 ， 除 
了 日 常 教学 ， 还 对 外 提供 一 些 天 于 渗透 测试 的 培 
Vil, Bw Lie. 


Walt Stoneburner， 软 件 架 构 师 ， 在 商业 应 用 
开发 与 咨询 领域 有 着 25 年 以 上 的 经 验 ， 另 外 在 软件 
质量 保证 、 配 置 管理 与 安全 领域 也 有 着 长 期 的 研 


AX 
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无 论 是 在 程序 设计 、 协 作 应 用 、 大 数据 、 知 识 
管理 、 数 据 可 视 化 ， 还 是 在 ASCII 方 面 ， 他 都 有 着 
很 深 的 造 训 。 甚 至 在 软件 评测 、 消 费 电 子 产 品 测 
评 、 绘 画 、 经 营 摄影 工作 室 、 创 作 幽 默 剧 、 游 戏 开 
发 、 无 线 电 等 领域 都 能 找到 他 的 身影 ， 他 还 自 
BR ARE” 





Yuri Weinstein， 生 活 在 旧金山 ， 有 超过 20 年 
的 时 间 束 职 于 硅谷 顶尖 的 技术 公司 ， 专 注 测 试 领 
域 ， 尤 其 是 在 目 动 化 测试 方向 。 目 前 在 红 帽 公司 负 
贡 Ceph 开 源 存储 项 目的 产品 质量 。 
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训 言 


Selenium 是 一 个 主要 用 于 Web 应 用 程序 自动 化 
测试 的 工具 集合 ， 在 行业 内 已 经 得 到 广泛 的 应 用 。 
然而 其 作用 不 局 限于 测试 领域 ， 还 可 以 用 于 屏 硕 抓 
取 与 浏览 器 行为 模拟 等 操作 。 它 文 持 主流 的 浏览 
ax,» €i45Firefox. IE. Chrome. Safari) /& Opera 
SS. 











Selenium 包 括 一 系列 的 工具 组 件 。 


e Selenium IDE: Hk A fl] Firefoxi] pias aE, 
用 于 在 Firefox 上 有 录制 与 回放 Selenium 脚本 。 图 
形 化 的 界面 可 以 形象 地 记录 下 用 户 在 浏览 右 中 
的 操作 ， 非 党 方便 使 用 者 了 解 与 学 习 。 目 前 它 
只 能 在 Firefox 下 使 用 ， 好 在 它 能 将 录制 好 的 脚 
本 转换 成 各 种 Selenium WebDriver 文 持 的 程序 语 








言 ， 进 而 扩展 到 更 广泛 的 浏览 器 类 型 。 

e Selenium WebDriver: 其 实质 上 残 是 可 以 文 持 多 
种 编程 语言 ， 并 且 有 用 于 操作 浏览 器 的 一 万 
API。 文 持 多 类 型 浏览 器 、 路 操作 系统 平台 【〈 包 
括 Linux、Windows 以 及 Mac OS X) ， 是 真正 意 
义 上 的 跟 浏 览 器 测试 工具 。WebDriver 为 诸如 
Java、C#、Python、Ruby、PHP、JavaScript 等 
语言 分 别提 供 了 完备 的 、 用 于 实现 Web 目 动 化 
测试 的 第 三 方 库 。 

e Selenium Standalone Server: 包括 被 大 家 广泛 了 
解 的 Selenium Grid、 远 程控 制 、 分 布 式 部 署 等 ， 
均 可 实现 Selenium 脚本 的 高 效 执行 与 拓展 。 我 
们 利用 Grid 使 得 上 自动 化 测试 可 以 并 行 运 行 ， 甚 至 
是 在 里 平台 、 措 构 的 环境 中 运行 ， 包 括 目 前 主 
流 的 移动 端 环境 ， 如 Android、iOS。 








正如 书 名 所 述 ， 这 是 一 本 介绍 如 何 用 Python 语 
言 调 用 Selenium WebDriver 接 口 ， 进 而 实现 对 Web 








应 用 自动 化 测试 的 指导 书 。 本 书 描述 了 从 Selenium 
安装 配置 到 基本 使 用 ， 再 到 创建 、 调 试 、 运 行 目 动 
化 脚本 等 进 阶 的 操作 。 当 然 在 开始 之 前 ， 你 可 能 需 
要 先 具 备 一 定 的 Python 语言 基础 。 


内 容 介 绍 


第 1 章 基 于 Python 的 Selenium WebDriver A | J 
从 安装 Python、Selenium WebDriver 开 始 ， 到 我 们 
如 何 选择 适合 的 Python 编辑 工 ， 以 及 我 们 小 试 牛 刀 
的 第 一 个 自动 化 测试 脚本 ， 并 且 成 功 地 将 这 一 脚本 
运行 在 人 不同 浏览 器 上 。 








第 2 草 使 用 unittest 编 写 单 元 测试 ”本 章 市 领 我 
们 结合 unittest 实 现 单 元 测试 。 通 过 转换 后 的 脚本 ， 
有 助 于 我 们 更 好 地 完善 单元 测 斌 用例。 借助 unittest 
实现 测试 用 例 集 的 整体 运行 ， 并 将 HTML 格 式 的 测 
试 结果 及 时 推送 给 项 目的 相关 人 员 。 





POR UAE, A UE VR UU A i s 
A iit IIE AC BN ZR FE TT RAC e 
Selenium 通 过 获取 这 些 元 素 的 定位 ， 进 而 实现 模拟 
浏览 占 操 作 与 参数 捕获 。 这 一 章 你 将 学 会 各 种 定位 











元 素 的 方法 ， 包 括 XPath 和 CSS 以 及 对 应 的 示例 。 


第 4 章 Selenium Python APINA — 学习 如 何 通 过 
WebDriver 与 包括 页 面 元 素 、JavaScript 提示 框 、 框 
38 (frames) 、 窗 口 在 内 的 各 类 对 象 进行 交互 ， 以 
及 怎样 进行 浏览 器 回放 、 元 素 传 值 、 妇 标 点击、 下 
拉 玉 单 选择 、 多 窗口 切换 等 具体 操作 。 











第 5 章 元 系 等 竺 机制” 介绍 多 种 设置 等 竺 方 
法 ， 用 于 提高 Selenium 上 自动 化 测试 脚本 的 稳定 运 
行 。 带 你 理解 显 式 等 竺 或 隐 式 等 待 的 方法 是 如 何 应 
用 于 我 们 的 测试 脚本 。 

















第 6 章 跨 浏览 器 测试 ”我 们 将 深入 学 习 如 何在 
远程 机 器 或 Selenium Grid 上 通过 Remote WebDriver 
实现 测试 脚本 路 各 类 型 浏览 右 的 测试 。Selenium 
Grid 可 使 得 我 们 在 多 浏览 句 与 多 操作 系统 的 排列 组 
合 中 茹 容 测 试 ， 甚 至 文 持 像 PhantomJS 这 样 的 无 Ul 
界面 的 浏览 器 。 本 草 的 最 后 ， 我 们 还 将 了 解 Sauce 





Labs 和 BrowserStack 等 第 三 方 外 部 测试 服务 ( 云 测 
Dis 

Be MMi lf A Selenium 
WebDriver. AppiumSEJ (E B$5iOS?m. Android?j; 
以 及 Android 模 拟 器 在 内 的 移动 设备 上 的 自动 化 测 
试 。 另 外 ， 本 章 还 有 App 测 斌 的 具体 示例 。 





58858 Page Object 与 数据 驱动 测试 ”介绍 这 两 
种 重要 的 设计 模式 ， 引 导 我 们 搭建 更 持续 、 更 高 效 
的 测试 框架 。 其 中 ，Page Object 设计 模式 可 帮助 我 
们 实现 对 界面 细 市 的 封 狼 ， 并 将 一 组 用 户 行为 构建 
在 单个 类 中 ， 提 升 上 自动 化 测试 脚本 的 易 谈 性 和 可 复 
用 性 ， 从 而 达到 更 适应 UI 的 频繁 变化 的 目的 。 男 
外 ， 我 们 还 将 学 习 用 unittest 实 现 数据 驱动 测试 。 








第 9 章 Selenium WebDriver 的 高 级 特性 ”包括 复 
杂 的 鼠标 与 键盘 操作 、cookies 操 作 、 窗 口 和 截屏， 其 
至 录制 整个 测试 过 程 。 





第 10 章 第 三 方 工具 与 框架 集成 ”通过 Selenium 
与 持续 集成 工具 的 搭配 ， 我 们 可 以 轻松 地 搭建 自动 
化 验收 测试 框架 。 本 章 中 展示 了 “通过 Selenium 创 建 
目 动 化 验收 测试 用 例 ， 然 后 细 化 基于 UI 的 目 动 化 测 
试 脚 本 ， 最 后 配置 持续 集成 工具 Jenkins， 最 终 实 现 
了 对 被 测 程序 每 日 构建 、 每 日 自动 化 验收 测试 的 联 
动 效 果 ” 的 典型 案例 。 




















通过 对 本 书 的 和 学习， 你 将 能 够 用 Python 语言 通 
过 调用 Selenium WebDriver 接 口 ， 搭 建 属于 你 目 己 
的 Web 应 用 目 动 化 测试 框架 。 





阅读 前 的 准备 工作 





在 阅读 本 书 之 前 ， 你 需要 掌握 python 语言 基本 
语法 以 及 Web 前 痪 的 相关 知识 《如 HIML、 
JavaScript、CSS 和 XML ) 。 如 果 你 能 编写 一 些 简 单 
的 包括 循环 、 条 件 判 断 、 定 义 类 等 语法 的 Python 脚 
本 ， 你 就 能 轻松 地 理解 本 书 中 的 示例 代码 。 每 行 示 
例 代码 我 们 都 花 了 很 大 精力 去 注释 说 明 ， 束 是 希望 
你 能 达到 最 佳 的 学 习 效 果 。 还 有 一 些 前 期 准备 的 软 
件 、 工 具 以 及 环境 配置 都 在 第 1 章 有 明确 的 说 明 ， 
你 二 要 在 你 的 机 右上 准备 好 访问 终 痢 、Python 解 释 
di OA AOI adis e 

















适合 哪些 人 阅读 


如 果 你 从 事 QA 或 软件 测试 、 软 件 开发 、Web 
应 用 开发 等 相关 工作 ， 和 希望 用 Python 语言 调用 
Selenium WebDriver， 以 实现 对 Web 应 用 的 自动 化 
测试 ， 那 么 这 本 书 一 定 是 你 较 好 的 选择 ! 在 学 习 
Selenium 理 论 之 前 ， 我 们 建议 你 掌握 Python 语言 的 
基本 语法 。 通 过 整 本 书 的 通 篇 学 习 ， 你 将 全 面 地 理 
解 Selenium WebDriver 的 相关 知识 ， 并 且 能 有 效 地 
帮助 你 实现 目 动 化 测试 。 








约定 


本 书 中 ， 你 可 能 会 发 现 不 同类 型 的 信息 ， 呈 现 
出 的 文本 风格 不 尽 相 同 。 我 们 在 这 里 将 罗列 不 同类 
型 的 文本 风格 以 及 对 应 的 作 义 ， 方 便 你 阅读 。 











代码 文本 的 样式 如 下 。 


# create a new Firefox session 
driver = webdriver.Firefox() 


driver.implicitly wait(30) 
driver.maximize window() 





当 我 们 想 格外 强调 代码 中 的 一 部 分 时 ， 相 应 的 
代码 字体 会 被 加 粗 ， 示 例如 下 。 


# run the suite 
xmlrunner.XMLTestRunner(verbosity=2, output='test-report 


s'). 
run(smoke tests) 





命令 行 的 输入 \ 输 出 的 样式 如 下 。 


EI ta re SR BEE A SRN A. KR BE 
句 就 是 指出 现在 系统 界面 、 亲 单项 或 对 话 框 等 位 置 
的 关键 操作 ， 例 如 , “在 Tools 下 拉 某 单 中 选择 


Internet Options". 








警告 或 重要 的 提示 ， 会 出 现在 这 样 的 括 





提醒 或 小 罕 门 ， 会 出 现在 这 样 的 括号 





eer 


我 们 十 分 乐 见 读者 的 反馈 ， 让 我 们 了 解 你 对 本 
书 的 想法 一 一 包括 好 与 不 好 的 评价 。 因 为 你 的 反馈 
将 使 我 们 以 后 可 以 更 好 地 为 读者 提供 有 价值 的 内 


IP 


容 。 








可 以 通过 我 们 的 邮箱 地 址 
contact Depubit.com.cn 将 你 的 反馈 信息 告诉 我 们 ， 
邮件 的 主题 需要 注 明 书籍 的 全 名 。 


当然 ， 如 果 你 也 有 专注 的 主题 ， 并 且 有 兴趣 编 
辑 或 把 与 图 书 ， 欢 迎 你 联系 我 们 ， 邮 箱 为 


zhangtao@ptpress.com.cn. 


第 1 章 ”基于 Python 的 Selenium 
WebDriver A | | 


Selenium 可 以 自动 地 操纵 浏览 器 来 做 很 多 事 
情 ， 它 可 以 模拟 我 们 与 浏览 器 的 交互 ， 比 如 ， 访 问 
网 站 ， 单 击 链接 ， 填 写 表 单 ， 提 交 表 单 ， 浏 览 网 页 
等 ， 而 且 文 持 大 多 数 主 流 的 浏览 句 。 如 果 要 使 用 
Selenium WebDriver， 我 们 首先 要 选择 一 种 语言 来 
编写 自动 化 脚本 ， 而 这 个 编程 语言 需要 有 Selenium 
client library 文 持 。 








本 书 中 ， 我 们 将 使 用 支持 Selenium client library 
的 Python 语 言 来 编写 目 动 化 脚本 。Python 是 一 门 被 
广泛 应 用 的 高 级 编程 语言 ， 它 是 非常 容易 上 手 的 ， 
而 且 它 的 语法 使 我 们 只 需要 简短 的 代码 就 可 以 用 来 
表达 思想 。Python 设 计 的 初衷 就 非常 强调 代码 的 可 
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段 的 还 是 很 少 的 程序 代码 ， 还 提供 大 量 的 内 置 库 、 
函数 以 及 用 户 编写 的 第 三 方 库 ， 从 而 能 够 很 容易 地 
实现 一 些 复 林 的 功能 。 


基于 Python 的 Selenium WebDriver client library 
实现 了 所 有 Selenium WebDriver 特 性 ， 而 且 能 够 通 
过 Selenium standalone server 来 远程 地 和 分 布 式 地 测 
试 B/S 项 目 。Selenium language bindings 的 开发 者 包 
< David Burns, Adam Goucher, Maik Röder, Jason 
Huggins, Luke Semerau, Miki Tebeka 和 Eric 
Allenin. 


Selenium WebDriver client library 文 持 以 下 
Python 版 本 : 2.6, 2.7, 3.2513.3. 


本 章 将 介绍 基于 Python 的 Selenium WebDriver 
client library 的 安装 步骤 、 基 本 特性 和 总 体 架 构 。 


本 章 包括 以 下 主题 


安装 Python 和 Selenium 包 ; 

选择 和 设置 Python 编辑 器 ; 

Selenium WebDriver 基 于 Python 编写 实例 脚本 ; 
实现 基于 下 和 Chrome 的 路 浏览 器 支持 。 


L1 WES 


作为 学 习 使 用 基于 Python 的 Selenium 的 第 一 
步 ， 我 们 需要 在 计算 机 上 安装 好 需要 的 软件 。 在 下 
面 的 章节 中 让 我 们 一 步 步 来 配置 所 需 的 基础 环境 。 





1.1.1 安装 Python 





在 安装 有 Linux 系 统 、Mac OS X 系 统 和 其 他 
UNIX 系 统 的 计算 机 上 ，Python 是 系统 默认 安装 好 
的 。 对 于 Windows 系 统 ， 束 需要 另外 单独 安装 
Python 了。 基于 不 同 平台 的 Python 安装 程序 都 可 以 
在 以 下 网 站 找到 : http://python.org/download/。 








本 书 所 有 的 例子 都 是 基于 Python 2.7 和 
Python 3.0 编 写 ， 并 在 Windows 8 系统 上 经 过 
测试 的 。 


Ll | 


1.1.2 安装 Selenium 包 





Selenium 安 装 包 里 包含 了 Selenium WebDriver 
Python client library。 为 了 使 安装 Selenium 4% f&j 
单 ， 可 以 用 pip 安 装 工具 : 
https://pip.pypa.io/en/latest/. 


使 用 pip， 可 以 非常 简单 地 通过 下 面 的 命令 来 
安装 和 更 新 Selenium 安 装 包 。 


安装 过 程 非常 简单 。 访 命令 将 会 安装 Selenium 
WebDriver client library 在 计算 机 上 ， 包 含 我 们 使 用 
Python 来 编写 上 自动 化 脚本 需要 的 所 有 模块 和 类 。Ppip 
工具 将 会 下 载 最 新 版 本 的 Selenium 安 装 包 并 安装 在 
计算 机 上 。 这 个 可 选 的 -U 参数 将 会 更 新 已 经 安装 
的 旧版 本 人 至 最 新 版 。 








th AT EAM ed v P ete AAS HY Selenium 2222 
包 : https://pypi.python.org/pypi/selenium. E (AI AY) 
右上 角 单 击 下载 按 钮 ， 下 载 后 解压 文件 ， 然 后 通过 
下 面 的 命令 来 安装 。 


python setup.py install 


1..3 X| Selenium WebDriver Python X 
Š 


Selenium WebDriver Python client library 文档 可 
DIMA TAHERA . 


http://selenium.googlecode.com/git/docs/api/py/ap 
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5 selenium.googlecode.com/git/docs/api/py/api.html 


Selenium 2.0 documentation » modules | index 


Table Of Contents Selenium Documentation 


Selenium 


seleniun(host, port, browserStartCommand, ...) Defines an object that runs Selenium commands. 


Common 


selenium.common.exceptions Exceptions that may happenin all the webdriver code. 


This Page 


How Source Webdriver.common 


selenium.webdriver.common.action chains The ActionChains implementation, 
selenium.webdriver.common.alert The Alert implementation. 
selenium.webdriver.common.by The By implementation. 
selenium.webdriver.common.desired capabilities The Desired Capabilities implementation. 
selenium.webdriver.common.keys The Keys implementation. 
selenium.webdriver.common.touch actions The Touch Actions implementation 
selenium.webdriver.common.utils The Utils methods. 
selenium.webdriver.common.proxy The Proxy implementation. 
selenium.webdriver.common.html5.application cache The ApplicationCache implementaion 


Webdriver.support 


selenium.webdriver.support.abstract event listener 





selenium.webdriver.support.color 








这 里 提供 了 Selenium WebDriver 的 所 有 核心 类 
和 了 水 数 的 详细 信息 。 对 于 以 下 链接 中 的 Selenium 文 
档 也 要 多 加 关注 。 


vy 


e H7; SCH: http://docs.seleniumhg.org/docs/. 3X 
里 有 关于 Selenium 所 有 组 件 的 说 明文 档 以 及 基于 
一 些 所 文 持 的 语言 编写 的 实例 。 

e Selenium Wiki 地 址 : 


https://code.google.com/p/selenium/w/list. ix Œ XJ 
举 了 将 在 后 面 的 章节 能 够 看 到 的 有 用 的 主题 。 











1.1.4 选择 一 个 IDE 


MECAZ Pythoni Selenium 
WebDriver， 还 需要 一 个 代码 编辑 器 (IDE) 来 编写 
自动 化 脚本 。 一 个 好 的 IDE 能 够 帮助 我 们 提高 产 
出 ， 而 且 还 能 做 一 些 其 他 的 事情 让 编码 变 得 简单 。 
当 我 们 用 简单 的 编辑 器 来 编写 Python 代码 ， 比 如 
Emacs、Vim 或 Notepad， 用 编辑 器 会 让 事情 变 得 简 
单 多 了 。 其 实 有 很 多 的 IDE 可 供 选择 。 一 般 来 说 ， 
一 蒜 好 的 IDE 能 够 通过 以 下 一 些 特 性 帮忙 开发 者 提 
高 开 友 速度 并 节省 编码 时 间 : 
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补 全 功能 ; 
。 方便 地 三 看 类 和 函数 代码 ; 


e 语法 高 亮 显 示 ; 





e 具备 项 目 管理 功能 ; 

。 文 持 代 码 模 板 ; 

。 具备 文 持 单 元 测试 和 调试 的 工具 : 
。 文 持 源 人 码 管理 。 





如 果 你 是 个 Python 开发 新 手 ， 或 者 是 第 一 次 接 
触 Python 的 测试 工程 师 ， 你 的 研发 同事 们 能 够 帮助 
你 安装 和 配置 相应 的 IDE。 


然而 ， 如 果 你 是 第 一 次 接触 Python 而 不 知 违 选 
择 哪 个 IDE， 这 里 有 些 建 议 可 以 帮助 你 做 出 选择 。 
1.1.4.1 PyCharm 

PyCharm 有 是 JetBrains 公 司 出 品 的 软件 ， 该 公司 
征 专 业 的 软件 开发 工具 的 引领 者 ， 产 品 包 含 大 家 数 
知 的 IntelliJ IDEA、RubyMine、PhpStorm 和 
TeamCity . 


PyCharm 是 一 球 设 计 精 巧 、 功 能 强大 、 应 用 广 


泛 而 且 工 作 恨 好 的 IDE。 它 继承 了 JetBrains 公司 其 
他 产品 的 一 贯 经 验 ， 拥 有 很 多 能 够 提升 软件 开发 效 
率 的 特性 。 


PyCharm 支 持 Windows 系 统 、Linux 系 统 和 Mac 
系统 。 要 想 知 道 更 多 PyCharm 的 特性 ， 可 以 访问 以 
下 网 址 : http;//www.jetbrains.com/pycharm/. 


PyCharm 有 两 种 版 本 一 一 社区 版 和 专业 版 。 社 
区 版 是 免费 的 ， 而 专业 版 古 需 要 付费 的 。 下 面 是 
PyCharm 社 区 版 运行 一 个 简单 Selenium 脚 本 例子 的 
截图 。 


社区 版 能 够 很 好 地 构建 和 运行 Selenium 脚 本 ， 
并 提供 调试 文 持 。 在 本 书后 面 的 章节 将 会 使 用 
PyCharm。 本 章 后 面 的 部 分 ， 我 们 一 步 步 来 安装 
PyCharm， 并 用 它 来 创建 第 一 个 Selenium 脚 本 。 











本 书 中 所 有 的 例子 都 是 用 PyCharm 构 建 
的 ， 不 过 读者 也 可 以 很 容易 地 应 用 别 的 IDE 来 
构建 这 些 例子 。 








File Edit View Navigate Code Refactor Run Tools VCS Window Help 





E setests final > k searchproducts with ie.py ^ 

BH Project *| © = | 次" fe | [A searchproducts.py x | \@& searchproducts with_ie.py x 

v DD setests final (C:\Users\amitr\Desk i 
IEDriverServer.exe 口 import os 
网 searchproducts.py Gfrom seleniun import webdriver 
网 searchproducts with ie.py | EE 


ae: i# get the path of I 
^ gh External Libraries : 








Mrunmayed 





:dir = os.getzwd() 
|ie driver | path = dir + "\IEDriverServer.exe" 


Lg create a nsy Internet Explorer session 
| driver - webiriver.Ie(ie driver path) 
|driver.implicitly wait(30) 

: driver.maximize window() 





gate to the appli 


aor getli'nttp: //demo. en com/"j] 


i # get the search textbox 
i search field - driver.find element by name("q") 
: search field.clear() 


ig enter search keyvord and submit 


| search field.send keys ("phones") 
: search field.submit() 






found 


i$ print the text i.e. name of 
1 for product in products: 
i print product.text 





i driver.quit () 











Run ^. searchproducts with ie 

p + 'C:\Python27\python. exe C:/Users/amitr/Desktop/Mrunmayee/Final/setests_final/searchproducts_with_ie.py 
‘ound 2 products: 

Bb + Madison Earbuds 

ll i$ Madison Overear Headphones 


gs | 











rocess finished with exit code 0 


1.1.4.2 PyDev Eclipse plugin 


PyDev Eclipse pluginzé 5j — 3X 4E Python F RÉ 
HAY A) YZ A Rt A. Eclipse — 3X X44 IF 


源 代 人 码 编辑 袁 ， 主 要 应 用 于 构建 Java 程 序 ， 它 通过 
插件 式 架 构 设 计 从 而 实现 对 其 他 多 种 编程 语言 的 文 


B. 


Eclipse 古 一 蒜 跨 平台 的 IDE， 文 持 Windows 系 
统 、Linux 系 统 和 Mac 系 统 。 可 以 在 以 下 网 址 获取 
Eclipse 的 最 新 版 


Æ: http://www.eclipse.org/downloads - 








PyDev plugin 需 要 在 安装 完 Eclipse 后 单独 安 
装 。 可 以 按照 Lars Vogel 编 写 的 安装 指南 来 安装 
PyDev: http://www.vogella.com/tutorials/Python/artic! 
也 可 以 在 以 下 网 址 查看 安 疙 说 明 : 
http://pydev.org/。 





下 面 是 使 用 PyDev Eclipse plugin 运行 一 个 简单 
Selenium 脚 本 例子 的 截图 。 





r 




















S PyDev - setests/fedexchecker.py - Eclipse o || & || s | 
File Edit Source Refactoring Navigate Search Project Pydew Run Window Help 
Be St Ea? Be EiT ys v oarn gm - 
Quick Access E | &j Java e PyDev 
[I$ PyDevPackageE.. 33. — O [P] fedexchecker 23 mE c 
Ev | fe TY from selenium import webdriver 


Š SESS driver = webdriver.Firefoxí() 
4 |P) fedexchecker.py driver.implicitly wait(30) 
© driver driver.zet("https://ww. fedex. can/fedextrack/”) 
€ python (CAPython27\pytl driver.find element by id("trackingByNumberNunbers").clear() 
driver.find element by id("trackhingByNumberNumbers").send keys("111111111111^") 
driver.find element by id(^trock tbn").click() 


print “Fracking information for Shipment” 

print “Stetus: ” + driver.find element by id("keyStotas").text 

print "Current Location: ”+ driver.find element by id("subStotus").text 
driver. quit() 


4 由 








El Console 23 x % Q, x IELE] r4 YEN E 
«terminated > C:\setests\setests\fedexchecker.py 

Tracking in^ormation for Shipment 

Status: In transit 

Current Location: INCHEON, KR 











4 m 上 


[P] Litem selected 





1.1.4.3 PyScripter 


对 于 Windows 系 统 的 用 户 ，PyScripter 也 是 一 个 
很 好 的 选择 。 它 是 一 球 开 源 的 、 轻 量 级 的 IDE。 
PyScripter 像 其 他 流行 的 IDE 一 样 具有 代码 编译 和 代 
人 码 目 动 补 全 的 特性 ， 并 且 提 供 测 试 和 调试 功能 
持 。 可 以 从 以 下 网 站 下 载 该 软件 并 获取 更 多 的 信 
li: https://code.google.com/ p/pyscripter/。 











下 面 是 在 PyScripter 上 运行 一 个 简单 Selenium 
脚本 实例 的 截图 。 














* from selenium import webdriver 













=) y fedexchecker. 













* driver = webdriver.Firefox() 






E Imports , * driver.implicitly wait(30) 
日 Ñ selenium 4 driver. get("https://wuw. fedex. com/ fedextrack/") 
webdriver * driver.find element by id("trackingByNumberNumbers").clear() 
=} Globals * driver.find element by id("trackingByNumberNumbers").send keys("111111111111' 





$ diver * driver.find element by id("track tbn").clicki) 














* print "Tracking information for Shipment" 
* print "Status: " + driver.find element by idi"keyStatus").text 

* print "Current Location: " + driver.find elenent by id("subStatus").text 
* driver. quit() 











` fedexcheckerpy X 





*** Python 2.7.6 (default, Nov 10 2013, 19:24:18) [MSC v.1588 32 bit (Intcl)] on win32. 
*** Remote Python engine is active *** 

>>> 

*** Remote Interpreter Reinitial:zed *** 

>>> 

Tracking information for Shipment 

Status: In transit 

Current Location: INCHEON, KR 

>>> 


5 © Python Interpreter 








1.1.5 PyCharmiz & 


我 们 看 过 这 些 可 选择 的 IDE 后 ， 回 到 PyCharm 





的 设置 。 本 书 中 所 有 的 例子 脚本 都 是 通过 PyCharm 
创建 的 ， 不 过 读者 也 可 以 使 用 其 他 IDE 来 创建 并 运 
行 这 些 实例 。 下 面 将 通过 以 下 步骤 来 设置 
PyCharm， 开 始 我 们 的 Selenium Python 之 旅 。 


(1) 从 JetBrains 官 网 下 载 和 安装 PyCharm。 


(2) 启动 PyCharm 社 区 版 ， 在 启动 页 面 上 单 
it; Create New Projectiz Ji. 





[区 PyCharm Community Edition lo |B | & | 
C Welcome to PyCharm Community Edition 
^ 


Recent Projects Quick Start 


pum 
[Bx Create New Project 


m 
[t Open Directory 


E Check out from Version Control 


P t Configure 
É Docs and How-Tos 


PyCharm Community Edition 3.0.2 Buld 131.618, Check for updates now, 





(3) 在 Create New Project 对 话 框 ， 参 考 下 面 
的 截图 ， 在 Project name 文 本 框 内 输入 工程 名 称 。 在 
本 例 中 ，setests 作 为 工程 名 称 。 第 一 次 运行 
PyCharm 还 需要 配置 解释 器 。 单 击 Interpreter 右 侧 的 
按钮 来 配置 解释 器 。 





F 
ME Create New Project re 


























Project name: |setests 
Location: C:\Users\AdminiPycharmProjects\setests | -| 
Interpreter: «no interpreter > v | Er | 
Æ No Python interpreter selected 
| Cancel | | Help 








(4) 在 弹出 的 Python Interpret} ie, $ 
击 加 号 ，PyCharm 会 显示 出 已 经 安装 好 的 解释 器 路 
径 。 从 Select Interpreter Path 选 择 对 应 的 解释 器 。 





| 
[+] 


= Select Interpreter Path || 


HS C:\python27\python.exe 


———1 











(5) PyCharm 将 会 配置 好 刚才 选择 的 解释 
髓 。 在 Packages 选 项 卡 会 显示 Python 安装 包 内 目 读 
的 一 些 工 具 包 。 单 击 Apply 按 钮 ， 然 后 单 击 OK 按 
EH o 








r 
E Python Interpreters 


© Python 2.7.6 (C:{Python27/python.exe) 


古训 1 + 到 


| Packages 
Package | Version | Latest i Install 


Django 1.6.1 1.6.1 





django-tagging 0.3.1 0.3.1 

pip 1.4.1 m 15 
selenium 2,39.0 2.39.0 
setuptools 2.0.1 um 2.0.2 
tagging 0.2.1 0.2.1 











oe] Cee [| 











(6) 返回 到 Create New Project*{ iste, "E 


OK 按钮 ， 项 目 创建 成 功 。 





1.2 第 一 个 Selenium Python 脚本 


我 们 现在 可 以 开始 创建 和 运行 目 动 化 测试 脚本 
了 。 就 从 Selenium WebDriver 开 始 ， 然 后 创建 一 个 
Python 脚本 ， 用 Selenium WebDriver 提 供 的 类 和 方 
法 模拟 用 户 与 浏览 器 的 交互 。 


我 们 会 使 用 一 个 简单 的 Web 应 用 程序 (本 书 上 
大 多 数 例子 都 是 基于 这 个 应 用 程序 ) 。 这 个 简单 的 
Web 应 用 程序 是 基于 一 个 车 名 电子 商务 框 染 
Magento 构 建 的 。 你 可 以 在 以 下 网 址 里 找到 这 个 应 


用 程序 :http://demo.magentocommerce.com/。 











示例 代码 下 载 


如 果 你 是 在 http:/packtpub.com 购 买 本 
书 ， 你 可 以 通过 你 的 账号 在 该 网 址 上 下 载 示 


例 代 码 文件 。 如 果 你 是 从 其 他 地 方 购买 本 
书 ， 你 可 以 访问 
http://www.packtpub.com/support 并 注册 ， 我 
们 会 把 示例 代码 文件 直接 发 送 到 你 的 邮箱 
中 。 


示例 代码 也 被 托管 在 github 中 ， 访 问 地 址 
https://github.com/upgundecha/learnsewithpytho 


No 





在 这 个 简单 的 脚本 中 ， 我 们 会 通过 接 下 来 的 步 
又 去 访问 这 个 应 用 程序 ， 搜 索 产 品 并 在 搜索 结果 页 
面 中 列 出 产品 的 名 称 。 





C1) 我 们 使 用 早 前 在 部 亚 PyCharm 环 境 时 创 
建 的 项 目 。 创 建 一 个 引用 了 Selenium WebDriver 
client library 的 Python 脚本 。 在 项 目 资源 管理 器 视图 
中 ， 右 击 setests， 在 弹出 的 豆单 中 依次 选择 
New 5 Python File. 








(lf. setests - [C\Users\Admin\PycharmProjects\setests] - PyCharm Community Edition 3.0.2 





File Edit View Navigate Code Refactor Run Tools VCS Window Help 








oa o|e [x ma | |j > me || ? 
3 setests ) 
Project ~ QI 
F3 setests (C:\Users\admin\PucharmPrniectsisetests 3 ! 
5- gf External Libraries E| Fie 









Ei € < Python 2.7.6 (C:/Pyt Y Cut 
m- 3 python-skeletons (| 团 Copy 
4) [73 Python2? (library h 


Ctrl+g © Directery 
ctrl4c Pythor Package 





Copy Path Ctrl+Shift+C — 

p E DLLs Copy Reference Ctrl+alt-+Shift+C — (M) HTML File 
+- [Lib rll Paste 

a B lib-tk - - 


Ctrl+V 


(2) 在 New Python file 对 话 框 中 ， 在 文件 名 
文本 框 中 输入 “searchproducts”"， 然 后 单 击 OK 按 
fl. 





fa New Python file 


Mame: |searchproducts 11 
Kind: A Python file x| 














(3) PyCharm 会 在 代码 编写 区 域 增 加 一 个 名 
为 searchproducts.py 的 新 页 签 。 复 制 下 列 代 码 到 
searchproducts.py 中 。 





from selenium import webdriver 


# create a new Firefox session 


driver = webdriver.Firefox() 
driver.implicitly wait(30) 
driver.maximize window() 


# navigate to the application home page 
driver.get("http://demo.magentocommerce.com/") 


# get the search textbox 
search field = driver.find element by name("q") 
search field.clear() 


# enter search keyword and submit 
search field.send keys("phones") 
search field.submit() 


# get all the anchor elements which have product names 

displayed 

# currently on result page using find elements by xpath 
method 

products = driver.find elements by xpath("//h2[Q.class-' 
product-name']/a") 


# get the number of anchor elements found 
print "Found " + str(len(products)) + " products:" 


# iterate through each anchor element and print the tex 
t that is 
# name of the product 
for product in products: 
print product.text 


# close the browser window 
driver.quit() 





如 果 你 使 用 的 是 其 他 IDE 编 译 工 具 ， 请 同 
样 创建 一 个 新 的 文件 ， 复 制 代码 到 文件 中 并 
保存 为 searchproducts.py。 





(4) 可 以 通过 以 下 方式 运行 脚本 : 在 
PyCharm 代 人 码 窗 口中 使 用 快捷 键 Ctrl + Shift+ F10 或 
者 在 Run 末 早 中 选择 Run 'searchproducts' 命 令 。 脚 
本 开始 执行 ， 你 会 看 到 新 弹出 一 个 Firefox 浏 览 霹 窗 
口 访问 演示 网 址 ， 接 痢 在 Firefox 浏 览 右 窗口 中 会 看 
到 被 执行 的 Selenium 命 令 。 如 有 果 一 切 运 行 顺利 ， 最 
后 脚本 会 天 闭 Firefox 浏 览 器 窗口 。 如 下 图 所 示 ， 这 
个 脚本 会 在 PyCharm 的 控制 台中 打印 产品 的 清单 。 


File Edit View Navigate Code Refactor Run Tools VCS Window Help 
3 setests final > fe searchproducts.py > 

EH Project ”| © = Xt I+) [È searchproducts.py x 

v Dsetests_final (C:\Users\amitr\PycharmProjects\ : 


应 searchproducts.py 
^ Wl External Libraries 




















rom selenium import webdriver 





create a ney Firefox session 
driver = webdriver.Firefox() 
.implicitly wait(30) 
driver.maximize window() 








navigate to the application home page 
driver.get("http://demo.magentocommerce.com/") 


# get the search textbox 
earch field = driver.find_element_by name("q") 
earch field.clear() 











enter search keyword and submit 
earch field.send_keys ("phones") 
earch field.submit() 











all the anchor elements h have product names displayed 
e 





rently on result pag ng find elements by xpath method 
ek = driver.find | nen ! by xpath ("//h2[@class='product-name']/a") 











get the number of anchor elements found 
rint "Found " + str(len(products)) + " products:" 





iterate through each anchor element and 
print the text that idis ame of the product 
i for product in products: 

i print product.text 





close the brovser vindov 
; driver.quit() 











Run e Searchpraducts 


ic: \Python27\python.exe C: /Users/amitr/PycharmProjects/setests_ final/searchproducts.py 
Found 2 products: 

MADISON EARBUDS 

MADISON OVEREAR HEADPHONES 


Process finished with exit code 0 








我 们 也 可 以 在 命令 行 中 运行 脚本 。 打 开 
命令 行 工 具 ， 切 换 到 setests 项 目 所 在 的 目录 





H 
中 ， 运 行 以 下 命令 


python searchproducts.py 


在 本 书后 面部 分 ， 我 们 更 喜欢 选择 使 用 
命令 行 方式 去 执行 测试 脚本 。 





接 下 来 ， 我 们 将 会 花 点 时 间 分 析 刚 才 创 建 的 脚 
本 。 我 们 分 析 每 个 语句 ， 初 步 地 认识 Selenium 
WebDriver。 在 本 书 的 后 面部 分 还 有 很 多 这 样 的 分 
析 。 








Selenium.webdriver 模 块 实现 了 Selenium 所 支持 
HS ee PRX V aS ZIEERE2S. ifüFirefox? vias. 
Chrome?X| (ids. IER Dias. Safari Vids e P 
EN ar. 77^, RemoteWebDriverll z& H F WH 
ERED LAs EFT DUI, ALT e 


我 们 需要 从 Selenium 包 中 导入 WebDriver 才 能 
使 用 Selenium WebDriver 方 法 。 


from selenium import webdriver 


Bet. RINE gs See A 7 3 — I 
它 会 提供 一 个 接口 去 调用 Selenium 命 令 来 跟 浏览 
交互 。 在 这 个 例子 i d IJ Xe Firefox yl) Ji, 
ao RITE VAG P 7r ig SR BSE N Firefoxi] Wi 
d JJ] SC] o 


driver - webdriver.Firefox() 


FEISTY HANA, ix — 4 3918 Firefoxi] Vis 
窗口 。 我 们 也 可 以 在 这 个 驱动 上 设置 一 些 参 数 ， 
如 : 








driver.implicityly wait(30) 


driver.maximize window() 





我 们 使 用 30 秒 隐 式 等 待 时 间 来 定义 Selenium 执 
行 步骤 的 超时 时 间 ， 并 且 调 用 Selenium API 来 最 大 
化 浏览 器 窗口 。 我 们 会 在 第 5 章 “ 元 素 等 待机 制 ?中 
学 习 更 多 关于 隐 式 等 待 的 内 容 。 





接着 ， 我 们 使 用 示例 程序 的 URL 作 为 参数 ， 通 
过 调用 driver.get() 方 法 访问 该 应 用 程序 。 在 get() 方 
法 被 调用 后 ，WebDriver 会 等 待 ， 一 直到 页 面 加 载 
完成 才 继 续 控 制 脚 本 。 


在 加 载 页 面 后 ，Selenium 会 像 用 户 真实 使 用 那 
样 ， 和 页 面 上 各 种 各 样 的 元 素 交 互 。 例 如 ， 在 应 用 
程序 的 主页 ， 我 们 需要 在 输入 框 中 输入 一 个 搜索 内 
容 ， 然 后 单 击 Search 按 钮 。 这 些 元 素 作为 HTML 输 
入 元 系 实 现 ，Selenium 需 要 找到 这 些 元 素来 模拟 用 
JF ENE. Selenium WebDriver 提 供 多 种 方法 来 定位 
和 操作 这 些 元 素 ， 例 如 设置 值 ， 单 击 按钮 ， 在 下 拉 
组 件 中 选择 选项 等 。 我 们 可 以 在 第 3 章 “ 元 素 定 
位 ”中 了 解 更 多 。 














在 这 个 例子 中 ， 我 们 使 用 
find_element_by_name 方 法 来 定位 搜索 输入 框 。 这 
个 方法 会 返回 第 一 个 name 属 性 值 与 输入 参数 匹配 的 











JUR. HTMLZUGR eH ee AOR XE MA, Baar 
AY Uf AEE fi ORE Thou, BRU R o 





C1) 在 这 个 例子 中 ， 搜 索 输 入 框 有 一 个 值 为 q 
的 name 属 性 ， 我 们 使 用 这 个 属性 来 定位 ， 代 码 如 
Te 








search_field = driver.find_element_by_name("q") 


(2) 一 旦 找到 这 个 搜索 输入 框 ， 我 们 可 以 使 
用 clear0) 方 法 来 清理 之 前 的 值 《如果 搜索 输入 框 已 
经 有 值 的 话 ) ， 并 且 通 过 send_keys0) 方 法 输入 新 的 
特定 的 值 。 接 着 我 们 通过 调用 submit() 方 法 提交 搜 
索 请 求 。 


search_field.clear() 


search field.send keys("phones") 
search field.submit() 





(3) 在 提交 搜索 请 求 后 ，Firefox 浏 览 器 会 加 
载 结果 页 面 。 结 果 页 面 中 有 一 系列 与 搜索 项 





(phones) 匹配 的 产品 。 我 们 可 以 读 取 结果 列表 ， 

并 且 可 以 使 用 find_elements_by_xpath 方 法 获取 路 径 
是 以 <a> 标 和 俭 结尾 的 所 有 产品 名 称 。 它 将 会 返回 多 
于 1 个 的 元 系列 表 。 





products = 
driver.find_elements_by_xpath("//h2[@class= 





'product-name' ]/a") 








(4) 接 痢 ， 我 们 打印 在 页 面 中 展示 的 产品 个 
数 《〈 即 符合 路 径 以 <a> 标 俭 结尾 的 元 素 个 数 ) 和 产 
品 的 名 称 《〈《 即 <a> 标 俭 的 text 属 性 值 ) 。 





print "Found " + str(len(products)) + " products:" 


for product in products: 
print product.text 





(50 在 脚本 的 最 后 ， 我 们 使 用 driver.quit() 方 
法 来 关闭 Firefox 浏 览 器 。 


driver.quit() 


这 个 例子 直观 地 回 我 们 展示 如 何 使 用 Selenium 
WebDriver 和 Python 配合 来 创建 一 个 徐 单 的 目 动 化 
脚本 。 我 们 在 这 个 脚本 里 面 并 没有 测试 什么 。 在 本 
书后 面 的 章节 ， 我 们 将 会 扩展 这 个 简单 的 脚本 为 一 
组 测试 脚本 ， 并 且 会 引用 多 个 其 他 库 和 Python 的 功 
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1.3 3 BEES DU as 


目前 我 们 已 经 在 Firefox 浏 览 器 构建 并 运行 了 脚 
本 。Selenium 文 持 各 种 浏览 右 ， 访 者 可 以 在 不 同 的 
DM Dias PRET E SUMMA. ESC READ ba as ELSIE 
浏览 器 、Google Chrome 浏 览 嚣 、Safari 浏 览 器 、 
Opera 浏 览 句 ， 甚 至 是 像 PhantomJS 这 样 的 无 UI 界 面 
的 浏览 器 。 接 下 来 的 部 分 ， 我 们 会 修改 刚才 创建 的 
脚本 ， 以 便 在 还 浏览 器 和 Google Chrome 浏 览 器 中 
运行 脚本 ， 以 此 来 验证 Selenium WebDriver 跨 浏览 
fit HI HE AE TIE 


1.3.1 设置 下 浏览 器 


在 下 浏览 磺 中 运行 脚本 步骤 会 多 一 些 。 我 们 需 
要 下 载 并 安装 InternetExplorerDriver。 
InternetExplorerDriver 是 一 个 独立 的 可 执行 的 服务 ， 
它 实 现 WebDriver 的 协议 ， 使 得 WebDriver 可 以 与 测 


AAAS ATED Ui As 22 H.. InternetExplorerDriver x ## 
Windows XP. Vista. Windows 7 和 Windows 8 操作 
系统 下 的 主要 正版 本 。 通 过 以 下 步骤 安装 


InternetExplorerDriver. 


(1) 7£http://www.seleniumhgq.org/download/# 
下 载 InternetExplorerDriver 服 务 。 你 可 以 根据 目 己 的 
操作 系统 来 选择 下 载 32 位 或 64 位 版 本 。 





(2) 在 下 载 完 成 后 ， 解 压 文件 ， 并 把 文件 复 
制 到 存储 脚本 的 目录 中 。 





(3) 在 正 7 及 其 以 上 版 本 ， 每 个 区 域 的 保护 模 
式 设置 一 定 要 有 相同 的 值 。 在 每 个 区 域 中 保护 模式 
要 么 启用 ， 要 么 关闭 。 设 置 保护 模式 的 步 又 如 下 。 


QD 在 工具 亲 单 下 选择 Internet 选 项 。 


在 Internet 选 项 对 话 框 中 ， 单 击 安全 标签 


O 在 “选择 区 域 以 查看 或 更 改 安全 设置 "中选 
择 每 一 个 区 域 ， 确 定 每 个 区 域 的 保护 模式 的 值 保持 
一 致 《要 么 选中 ， 要 么 不 选中 ) 。 所 有 区 域 用 相同 
的 设置 ， 如 下 图 所 示 。 








This zone is for Internet websites, 
excep: those listed in trusted and 
restricted zones. 


Security level for this zone 
Allowed levels for this zone: Medium to High 
Medium-high 
- Appropriate for most websites 
- Prompts before downloading potentially unsafe 


content 
- Unsigned ActiveX controls will not be downbaded 


Enable ?rotected Mode (requires restarting Interne: Explorer) 
| Custom level... De:ault level 





[ Reset all zones to default level 








在 使 用 InternetExplorerDriver 时 ， 注 意 保 
持 浏 览 右 缩放 等 级 设置 成 100%， 以 此 来 保证 
忌 标 的 单 击 事件 能 点 到 正确 的 坐标 。 





(4) 修改 脚本 使 其 支持 下 浏览 器 。 我 们 通过 
以 下 方式 来 使 用 了 正 蔡 代 EFirefox 实 例 。 





import os 
from selenium import webdriver 


# get the path of IEDriverServer 
dir = os.path.dirname( file ) 
ie driver path = dir + "MIEDriverServer.exe" 


# create a new Internet Explorer session 
driver - webdriver.Ie(ie driver path) 
driver.implicitly wait(30) 
driver.maximize window() 


# navigate to the application home page 
driver.get("http://demo.magentocommerce.com/") 


# get the search textbox 
search field = driver.find element by name("q") 
search field.clear() 


# enter search keyword and submit 
search field.send keys("phones") 
search field.submit() 


# get all the anchor elements which have product names 

displayed 

# currently on result page using find elements by xpath 
method 

products = driver.find elements by xpath("//h2[()class-' 
product-name']/a") 


# get the number of anchor elements found 
print "Found " + str(len(products)) + " products:" 


# iterate through each anchor element and print the tex 
t that is 
# name of the product 
for product in products: 
print product.text 


# close the browser window 
driver.quit() 





在 这 个 脚本 中 ， 在 创建 下 浏览 右 实 例 时 ， 我 们 
传递 了 InternetExplorerDriver 的 路 径 。 


(5) 运行 脚本 后 ，Selenium 会 加 载 
InternetExplorerDriver 服 务 ， 用 它 来 局 动 浏 览 器 和 执 
行 脚本 。InternetExplorerDriver 服 务 在 Selenium 脚 本 


ALD eas ZT) dr AST IP A E. SEPT LZ 
与 我 们 在 Firefox 浏 览 器 观察 的 类 似 。 


3 


TEhttps://code.google.com/p/selenium/wiki/ 





InternetExplorerDriver 中 可 以 获取 更 多 关 
于 IE 的 重要 设置 。 


在 https://code.google.com/p/selenium/wiki/ 


DesiredCapabilities 查阅 
DesiredCapabilities 的 文章 。 





NWA HE 


1.3.2 iGoogle Chrome 浏 览 器 


在 Google Chrome 浏 览 器 中 设置 和 运行 脚本 的 
步骤 与 正 浏 览 右 的 相似 。 我 们 需要 下 载 
ChromeDriver 服 务 。ChromeDriver 服 务 是 一 个 由 
Chromium team 开 发 维护 的 独立 的 服务 ， 它 文 持 





Windows 操 作 系 统 、Linux 操 作 系 统 和 Mac 操 作 系 
统 。 使 用 以 下 步骤 来 设置 ChromeDriver 服 务 。 


(1) 在 
http://chromedriver.storage.googleapis.com/index.html 


下 载 ChromeDriver 服 务 。 


(2) 下 载 完 ChromeDriver 服 务 后 ， 解 压 文 
件 ， 并 把 文件 复制 到 存储 脚本 的 目录 中 。 





(3) 修改 脚本 使 其 支持 Chrome 浏 览 器 。 我 们 
通过 以 下 方式 创建 Chrome 实 例 ， 用 此 来 蔡 换 Firefox 
浏览 器 实例 。 





import os 
from selenium import webdriver 


# get the path of chromedriver 

dir = os.path.dirname( file ) 

chrome driver path = dir + "\chromedriver.exe" 

# remove the .exe extension on linux or mac platform 


# create a new Chrome session 
driver = webdriver.Chrome(chrome_driver_path) 


driver.implicitly wait(30) 
driver.maximize window() 


# navigate to the application home page 
driver.get("http://demo.magentocommerce.com/") 


# get the search textbox 
search field = driver.find element by name("q") 
search field.clear() 


# enter search keyword and submit 
search field.send keys("phones") 
search field.submit() 


# get all the anchor elements which have product names 

displayed 

# currently on result page using find elements by xpath 
method 

products = driver.find elements by xpath("//h2[Q)class-' 
product-name']/a") 


# get the number of anchor elements found 
print "Found " + str(len(products)) + " products: " 
# iterate through each anchor element and print the tex 
t that is 
# name of the product 
for product in products: 
print product.text 


# close the browser window 
driver.quit() 





在 这 个 脚本 中 ， 在 创建 Chrome 浏 览 器 实例 时 ， 


我 们 传递 了 ChromeDriver 的 路 径 。 


(4) 运行 脚本 后 ，Selenium 会 加 载 
ChromeDriver 服 务 ， 用 它 来 局 动 浏览 器 和 执行 肢 
AX 
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Q 

想 了 解 更 多 关于 ChromeDriver， 请 访问 
https://code.google.com/p/selenium/ 
wiki/ChromeDriver 和 和 


https://sites.google.com/a/chromium.org/chrome 


driver/ home. 





14 章节 回顾 


在 本 章 中 ， 我 们 介绍 了 Selenium 和 它 的 组 件 。 
通过 pip 工 具 安 装 了 Selenium 包 。 接 着 介绍 了 多 个 用 
于 编写 Selenium 和 Python 代码 的 ii as AIDE LA, 
部 普 了 PyCharm 坏 境 。 然 后 我 们 通过 创建 基于 示例 
程序 的 斌 脚本， 成 功 运 行 在 Firefox 浏 览 器 ， 并 分 
析 了 整个 过 程 。 最 后 ， 我 们 举一反三 〔 分 列 在 下 浏 
DE riii bias PAC IS TI NA SES ub 
Selenium WebDriverHJ £5 il vias HJ SE PE e 








在 下 一 章 ， 我 们 将 学 习 如 何 通过 Selenium 
WebDriver 使 用 unittest 库 来 创建 自动 化 单元 测试 。 
我 们 也 将 学 习 如 何 创建 并 运行 一 组 测试 脚本 。 


2 {tA unittest2iq 5 Æ% JG 
测试 


Selenium WebDriver 是 一 个 浏览 占 目 动 化 测试 
的 API 集 合 。 它 提供 了 很 多 与 浏览 器 目 动 化 交互 的 
特性 ， 并 且 这 些 API 主 要 是 用 于 测试 Web 程 序 。 如 
果 仪 仅 使 用 Selenium WebDriver， 我 们 无 法 实现 执 
行 测 试 前 置 条 件 、 测 试 后 置 条 件 ， 比 对 预期 结果 和 
实际 结 采 ， 检 得 程 序 的 状态 ， 生 成 测试 报告 ， 创 建 
数据 驱动 的 测试 等 功能 。 在 本 章 ， 我 们 将 学 习 如 何 
使 用 unittest 来 创建 基于 Python 的 Selenium 
WebDriver 测 试 脚本 。 











本 草包 含 以 下 主题 : 


e 什么 是 unittest? 
。 使 用 unittest 来 写 Selenium WebDriverillll ix; 


。 用 TestCase 类 来 实现 一 个 测试 ; 

。 学 习 unittest 提 供 的 不 同类 型 的 assert 方 法 ; 
e 为 一 组 测试 创建 TestSuite; 

。 使 用 unittest 扩 展 来 生成 HTML 格 式 的 测试 报告 。 





2.1 unittest 单 元 测试 框架 


unittest〈 一 般 称 为 PyUnit) 是 从 Java 程 序 开 发 
中 三 泛 应 用 的 JUnit 局 发 而 来 的 。 我 们 可 以 使 用 
unittest 为 任何 项 目 创 建 全 面 的 测试 套件 。unittest 也 
是 Python 中 用 来 测试 各 种 标准 类 库 模 块 的 ， 甚 至 包 
括 unittest 目 己 。 可 以 在 以 下 网 址 得 看 unittest 的 文 
Ri: http://docs.python.org/2/library/unittest.html . 


unittest 使 我 们 具备 创建 测试 用 例 、 测 试 套件 、 
测试 夹具 的 能 力 。 可 以 通过 下 面 的 图 来 了 解 所 有 的 
组 件 。 





e Test Fixture MAKK) : 通过 使 用 测试 夹 
其， 可 以 定义 在 单个 或 多 个 测试 执行 之 前 的 准 
备 工 作 和 测试 执行 之 后 的 清理 工作 。 

e Test Case 〈 测 试用 例 ) : 一 个 测试 用 例 是 在 
unittest 中 执行 测试 的 最 小 单元 。 它 通过 unittest 











提供 的 assert 方 法 来 验证 一 组 特定 的 操作 和 输入 
以 后 得 到 的 具体 啊 应 。unittest 提 供 了 一 个 名 称 
为 TestCase 的 基础 类 ， 可 以 用 来 创建 测试 用 例 。 

e Test Suite (测试 套件 );: 一 个 测试 套件 是 多 个 
测试 或 测试 用 例 的 集合 ， 是 针对 被 测 程序 的 对 
应 的 功能 和 模块 创建 的 一 组 测试 ， 一 个 测试 套 
件 内 的 测试 用 例 将 一 起 执行 。 

e Test Runner MINAT) : 测试 执行 器 负责 
测试 执行 调度 并 且 生 成 测试 结果 给 用 户 。 测 试 
执行 器 可 以 使 用 图 形 界面 、 文 本 界面 或 者 特定 
的 返回 值 来 展示 测试 执行 结 

e Test Report (测试 报告 ) : 测试 报告 用 来 展示 
所 有 执行 用 例 的 成 功 或 者 失败 状态 的 汇总 ， 执 
行 失败 的 测试 步骤 的 预期 结 末 与 实际 结 末 ， 还 
有 整体 运行 状况 和 运行 时 间 的 汇总 。 




















Test 
Fixture 


uite System/Application Under Test 


Test | 
Runner 


Test | —— 
S 





通过 与 unittest 类 似 的 xUnite 测 试 框架 创建 的 测 
试 被 拆 分 为 3 部 分 ， 即 3A’*s， 具 体 如 下 。 





。Arrange: 是 用 来 初始 化 测试 的 前 置 条 件 ， 包 含 
初始 化 被 测试 的 对 象 、 相 关 配 置 和 依赖 。 

。Act: 用 来 执行 功能 操作 。 

e Assert: 用 来 校 验 实际 结果 与 预期 结果 是 否 一 
BX 











我 们 在 本 章 接 下 来 的 内 容 中 将 应 用 此 方法 来 使 
用 unittest 创 建 测试 。 


A 








我 们 将 在 本 书 接 下 来 的 部 分 使 用 unittest 
来 创建 和 运行 基于 Selenium WebDriver 的 测 
试 。 另 外 ，Python 还 有 些 具 备 额 外 特性 的 其 
他 测试 框架 ， 例 如 : 











e Nose: 此 框架 扩展 了 unittest 并 且 提 供 了 
目 动 搜索 和 运行 测试 的 功能 ， 也 提供 了 
一 些 插件 来 创建 高 级 的 测试 。 可 以 在 以 
下 网 站 查看 关于 Nose 的 更 多 信息 。 
https://nose.readthedocs.org/en/latest/ 


e Pytest: Pytest 是 男 外 一 个 测试 框架 ， 它 
提供 了 一 些 基 于 Python 来 编写 和 运行 单元 








测试 的 高 级 特性 。 可 以 在 以 下 网 站 碍 看 
关于 Pytest 的 更 多 信息 。 
http://pytest.org/latest/ 





2.1.1 TestCase 类 


我 们 可 以 通过 继承 TestCase 类 并 且 在 测试 类 中 
为 每 一 个 测试 深 加 测 试 方法 来 创建 单个 测试 或 者 一 
组 测试 。 为 了 创建 测试 ， 我 们 雷 要 使 用 TestCase 类 
中 的 assert 或 者 使 用 其 中 的 一 种 assert 方 法 。 每 个 测 
试 最 重要 的 任务 是 调用 assertEqual0) 来 校 验 预 期 结 
果 ， 调 用 assertTrue() 来 验证 条 件 ， 或 者 调用 
assertRaises() 来 验证 预期 的 异常 。 


除了 添加 测试 ， 我 们 可 以 添加 测试 夹具 一 一 
setUp() 方 法 和 tearDown0 方 法 ， 创 建 或 处 置 测 试用 
例 所 需要 的 任何 对 象 和 条 件 。 


让 我 们 开始 使 用 unittest， 首 先 通过 继承 


TestCase 类 然后 添加 一 个 测试 方法 ， 来 为 第 1 章 〈 基 
于 Python 的 Selenium WebDriver 入 门 ) 中 的 例子 脚 
本 与 一 个 简单 的 测试 。 


我 们 需要 先 引 入 unittest 模 块 ， 然 后 定义 一 个 继 
承 于 TestCase 类 的 子 类 ， 具 体 如 下 。 


import unittest 
from selenium import webdriver 





class SearchTest (unittest.TestCase): 


2.1.1.1 setUpQ77 i: 


一 个 测试 用 例 是 从 setUp0 方 法 开始 执行 的 ， 我 
们 可 以 用 这 个 方法 在 每 个 测试 开始 前 去 执行 一 些 初 
始 化 的 任务 。 可 以 是 这 样 的 初始 化 准备 : 比如 创建 
浏 唤 絮 实例， 访问 URL， 加 载 测 试 数据 和 打开 日 志 
文件 等 。 








此 方法 没有 参数 ， 而 且 不 返回 任何 值 。 当 定义 
了 一 个 setUp() 方 法 ， 测 试 执行 器 在 每 次 执行 测试 方 


法 之 前 优先 执行 该 方法 。 在 下 面 的 例子 里 ， 我 们 将 
用 setUp0 方 法 来 创建 Firefox 的 实例 ， 设 置 
properties， 而 且 在 测试 开始 执行 之 前 访问 到 被 测 程 
序 的 主页 。 例 子 如 下 。 


import unittest 
from selenium import webdriver 


class SearchTests(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.co 





2.1.1.2. 编写 测试 


有 了 setUp0 方 法 ， 现 在 可 以 写 一 些 测 试用 来 验 
证 我 们 想 要 测试 的 程序 的 功能 。 在 这 个 例子 里 ,我 
们 将 搜索 一 个 产品 ， 然 后 检查 是 否 返 回 一 些 相 应 的 
结果 。 与 setUp0 方 法 相似 ，test 方 法 也 是 在 TestCase 





类 中 实现 。 重 要 的 一 点 是 我 们 需要 给 测试 方法 命名 
为 test 开 头 。 这 种 命名 约定 通知 test runner 哪 个 方法 
代表 测试 方法 。 


对 于 test runner 能 找到 的 每 个 测试 方法 ， 都 会 在 
执行 测试 方法 之 前 先 执行 setUp(0) 方 法 。 这 样 做 有 助 
于 确保 每 个 测试 方法 都 能 够 依赖 相同 的 环境 ， 无 论 
类 中 有 多 少 测试 方法 。 我 们 将 使 用 简单 的 
assertEqual()77 15:3 uE FH] FE FF 48 28 VAI Ya Ind P £s 
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探讨 更 多 关于 上 断言 的 内 容 。 











添加 一 个 新 的 测试 方法 
test_search_by_category()， 通 过 分 类 来 搜索 产品 ， 
然后 校 验 返 回 的 产品 的 数量 是 否 正 确 ， 其 体 如 下 。 





import unittest 
from selenium import webdriver 


class SearchTests(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 


self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.co 


m/") 


def test search by category(self): 
# get the search textbox 
self.search_field = self.driver.find_element_by 
.name("q") 
self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys("phones") 
self.search field.submit() 


4 get all the anchor elements which have produc 
t names 
# displayed currently on result page using 
4 find elements by xpath method 
products - self.driver.find elements by xpath 
("//h2[Qclass-'product-name']/a") 
self.assertEqual(2, len(products)) 





2.1.1.3 ”代码 清理 





类 似 于 setUp0 方 法 在 每 个 测试 方法 之 前 被 调 
用 ，TestCase 类 也 会 在 测试 执行 完成 之 后 调用 
tearDown() 方 法 来 清理 所 有 的 初始 化 值 。 一 旦 测试 


被 执行 ， 在 setUp(0 方 法 中 定义 的 值 将 不 再 需要 ， 上 所 
以 最 好 的 做 法 是 在 测试 执行 完成 的 时 候 清 理 挥 由 
setUp() 方 法 初始 化 的 数值 。 在 我 们 的 例子 里 ， 在 测 
试 执行 完成 后 ， 吏 不 再 需要 Firefox 的 实例 。 我 们 将 
在 tearDown0 方 法 中 关闭 Firefox 实 例 ， 如 下 代码 所 
de 








import unittest 
from selenium import webdriver 


class SearchTests(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver - webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.co 


m/") 


def test search by category(self): 
# get the search textbox 
self.search field = self.driver.find element by 
.name("q") 
self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys("phones") 


self.search_field.submit() 


# get all the anchor elements which have produc 
t names 
# displayed currently on result page using 
# find elements by xpath method 
products = self.driver.find elements by xpath 
("//h2[Qclass-'product-name']/a") 
self.assertEqual(2, len(products)) 


def tearDown(self): 
4 close the browser window 
self.driver.quit() 





2.1.1.4 ”运行 测试 

为 了 通过 命令 行 运行 测试 ， 我 们 可 以 在 测试 用 
例 中 添加 对 main 方 法 的 调用 。 我 们 将 传递 verbosity 
参数 以 便 使 详细 的 测试 总 量 展示 在 控制 台 。 











unittest.main(verbosity=2) 





我 们 可 以 把 测试 脚本 保存 为 普通 的 Python 脚 
本 。 在 这 个 例子 里 ， 把 测试 保存 为 searchtests.py。 
保存 文件 以 后 ， 我 们 可 以 通过 下 面 的 命令 行 来 执行 
该 测试 。 


python searchtests. py 


测试 运行 结束 后 ，unittest 会 把 测试 结果 和 概要 
展示 在 控制 合 ， 如 下 图 所 示 。 








C:\Windows\system32\cmd.exe 


:\\setests\chapter2>searchtests.py 
est_search_by_category (__main__.SearchTests) ... ok 





除了 测试 结果 概要 外 ， 当 一 个 测试 用 例 执行 失 
败 ， 针 对 每 个 失败 ， 测 试 结果 概要 都 会 通过 生成 文 
本 信息 来 展示 具体 哪里 有 和 错误。 通过 下 面 的 截图 
可 以 看 到 当 我 们 修改 预期 结果 值 后 会 发 生 些 什么 。 








E C:\Windows\system32\cmd.exe 


:\\setests\chapter 2>searchtests .py 
est search by category ( main .SearchTests) ... FAIL 


— Ó — t recent call last): 
Fi "C:\setests\chapter2\s a PM ts.py", line 26, in test search by category 


elf.as rh o e A PEE, 
As sertionError: 


FAILED (failures-1) 








上 图 展示 了 具体 是 哪个 测试 方法 执行 失败 ， 
过 打印 信息 可 以 退 踩 具体 导致 失败 的 代码 。 另 外 ， 
自身 也 会 以 AssertionError 形 式 显 示 ， 例 子 中 的 
页 期 结果 和 实际 结果 并 不 匹配 。 











2.1.1.5 28 JH fth IU 

我 们 可 以 用 一 组 测试 来 构建 一 个 测试 类 ， 这 样 
有 助 于 为 一 个 特定 功能 创建 一 组 更 合乎 逻辑 的 测 
试 。 下 面 为 测试 类 添加 其 他 的 测试 。 规 则 很 简单 ， 
新 的 测试 方法 命名 也 要 以 test 开 头 ， 如 下 列 代码 。 


def test_search_by_name(self): 
# get the search textbox 


self.search field = self.driver.find element by 
 name("q") 
self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys("salt shaker") 
self.search field.submit() 


# get all the anchor elements which have 

# product names displayed 

# currently on result page using 

# find elements by xpath method 

products = self.driver.find elements by xpath 
("//h2[Qclass-'product-name']/a") 

self.assertEqual(1, len(products)) 





运行 这 个 测试 类 将 能 看 到 两 个 Firefox 的 实例 打 
开 和 关闭 ， 这 正 是 setUp0 方 法 和 tearDown() 方 法 针 
对 每 个 测试 方法 都 要 执行 产生 的 结果 ， 如 下 图 所 
示 。 





E C:\Windows\system32\cmd.exe 


:\setests\chapter2>searchtests.py 
est_search_by_category (_main__.SearchTests) ... 
est_search_by_name (__main__.SearchTests) ... ok 





2.1.2 ”类 级 别 的 setUp(0) 方 法 和 tearDown() 


FTE 

在 前 面 的 例子 中 ， 我 们 通过 setUp(0 方 法 为 每 个 
测试 方法 都 创建 了 一 个 Firefox 实 例 ， 并 且 在 每 个 测 
试 方法 执行 结束 后 都 要 关闭 实例 。 能 人 否 让 各 个 测试 
A E 而 不 要 每 次 都 创建 一 个 
新 的 实例 呢 ? 这 可 以 通过 使 用 setUpClass0 方 法 和 
tearDownClass() 方 法 及 @classmethod 标 识 来 实现 。 
这 两 个 方法 使 我 们 可 以 在 类 级 别 来 初始 化 数据 ， 蔡 
代 了 方法 级 别 的 初始 化 ， 这 样 各 个 测试 方法 残 可 以 
共享 这 些 初 始 化 数据 。 在 下 面 的 例子 中 ， 代 但 修改 
为 调用 setUpClass() 方 法 和 tearDownClass() 方 法 并 且 
加 上 人 @classmethod 标 识 。 








import unittest 
from selenium import webdriver 


class SearchTests(unittest.TestCase): 
@classmethod 
def setUpClass(cls): 
# create a new Firefox session 
cls.driver = webdriver.Firefox() 
cls.driver.implicitly wait(30) 


/") 


cls.driver.maximize window() 


# navigate to the application home page 
cls.driver.get("http://demo.magentocommerce.com 


cls.driver.title 


def test search by category(self): 


 name("q 


t names 


# get the search textbox 
self.search field - self.driver.find element by 
") 


self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys("phones") 
self.search field.submit() 


# get all the anchor elements which have produc 


# displayed currently on result page using 

it find elements by xpath method 

products = self.driver.find elements by xpath 
("//h2[Qclass-'product-name']/a") 

self.assertEqual(2, len(products)) 


def test search by name(self): 


 name("q 


# get the search textbox 
self.search field - self.driver.find element by 
") 


self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys("salt shaker") 
self.search field.submit() 


# get all the anchor elements which have produc 
t names 
# displayed currently on result page using 
# find elements by xpath method 
products = self.driver.find elements by xpath 
("//h2[@class=' product-name' ]/a") 
self.assertEqual(1, len(products) ) 


@classmethod 

def tearDownClass(cls): 
# close the browser window 
cls.driver.quit() 


if name == ' main ': 
unittest .main() 





运行 这 个 测试 将 看 到 仅 创 建 一 个 Firefox 实 例 ， 
所 有 的 测试 都 用 同一 个 实例 。 


要 了 解 更 多 关于 @classmethod 标 识 的 信 
A, 275. https://docs.python.org/2/library/ 


functions.htmlzzclassmethod o 





2.1.3 断言 


unittest 的 TestCase 类 提供 J Han 
校 验 预 期 结果 和 程序 返回 的 实际 结果 是 否 一 致 。 
些 方法 要 求 必 须 满足 茶 些 条 件 才能 继 乡 niis 
Hyd. AOBORHOGTMUXTEHUJJJIA, TRE: E 
KARRE SUPER. ARES Sar PU RE aS BS 
验 。 如 果 给 定 的 断言 通过 了 ， 接 下 来 的 测试 代码 将 
会 执行 ， 相 反 ， 将 会 导致 测试 立即 停止 并 且 给 出 异 
各 信息 。 











unittest 提 供 了 所 有 的 标准 xUnit 断言 方法 。 下 
表 列 出 了 一 些 在 本 书后 面 将 要 用 到 的 重要 方法 。 


| 
assertEqual(a, b [,msg]) la==b | 这 些 方法 校 验 a 和 b 是 否 = ，msg 对 象 是 用 


来 说 明 失 败 原 因 的 消 筷 
assertNotEqual(a, 这 对 于 验证 元 素 的 值 和 属 性 等 是 非常 有 用 
bLmsg]) 的 。 例 如 : 


assertEqual(element.text, "10") 


assertTrue(x[,msg])) |boolx)is True | 这些 方法 E 校 验 给 出 的 表达 式 是 True 还 是 
Fal bool(x) is Fal pm 
asser CRDI |bool(x)isFalse — 例如 ” 校 验 一 个 元 素 是 否 出 现在 页 面 ， 我 们 


可 以 用 下 面 的 方法 : 


assert True(element.is_displayed()) 






















































































assertIsNot(a, b[,msg])) ais not b 


fun(*args, 

**kwds) raises 

ES 这 些 方法 校 验 特定 的 异常 是 否 被 具体 的 测试 
fun(*args,**kwds) | 步骤 抛 出 ， 用 到 该 方法 的 一 种 可 能 情况 是 ; 


NoSuchElementFoundexception 


assertRaises(exc, fun, 
*args, **kwds) 
































assertRaisesRegexp(exc, raises exc and the 
r, fun, *args, **kwds) message matches 





regex r 


assertAlmostEqual(a, b) round(a-b, 7) == 0 | 这 些 方法 用 于 检查 数值 ， 在 检查 之 前 会 按照 
给 ; 


给 定 的 精度 把 数字 四 舍 五 入 。 这 有 助 于 统计 
assertNotAlmostEqual(a, round(a-b, 7) != 0 由 于 四 舍 五 入 产生 的 错误 和 其 他 由 于 浮 点 运 


b) 算 产 生 的 问题 
ey 判定 条 件 设计 的 



























































assertNotRegexpMatches(s, 这 些 方法 检查 文本 FE 则 匹配 
i) not r.search(s) 


此 方法 是 assertEqual0 的 一 种 特殊 形式 ， 为 多 
m THEE. MERE AL A TH R 
assertMultiLineEqual(a, b) | strings 校 验 一 样 ， 但 是 默认 失败 信息 经 过 优化 以 后 


可 以 展示 具体 值 之 间 的 差别 


此 方法 是 无 条 件 的 失败 。 在 别 的 assert 方 法 不 
fail() oe 时 候 ， 也 可 用 此 方法 来 创建 定制 的 条 
HE 
































































































































2.1.4 测试 套件 


应 用 unittest 的 TestSuites 特 性 ， 可 以 将 不 同 的 测 
试 组 成 一 个 逻辑 组 ， 然 后 设置 统一 的 测试 套件 ， 并 
通过 一 个 命令 来 执行 测试 。 这 都 是 通过 TestSuites、 


TestLoader 和 Test Runner 类 来 实现 的 。 


fE I ff TestSuites]Zl T3 ZA, 34 12349] T TF 
添加 一 个 新 的 测试 ， 用 于 校 验 主 页 。 我 们 将 把 新 加 





的 测试 和 之 前 的 测试 放 到 一 个 测试 组 件 中 ， 详 见 下 
面 代码 。 





import unittest 

from selenium import webdriver 

from selenium.common.exceptions import NoSuchElementExc 
eption 

from selenium.webdriver.common.by import By 

from _ builtin__ import classmethod 


class HomePageTest(unittest.TestCase): 

@classmethod 

def setUp(cls): 
# create a new Firefox session 
cls.driver = webdriver.Firefox() 
cls.driver.implicitly wait(30) 
cls.driver.maximize window() 
# navigate to the application home page 
cls.driver.get("http://demo.magentocommerce.com 


/") 


def test_search_field(self): 
# check search field exists on Home page 
self.assertTrue(self.is element present(By.NAME 


»"q")) 


def test language option(self): 
# check language options dropdown on Home page 
self.assertTrue(self.is element present 
(By.ID,"select-language")) 


def test shopping cart empty message(self): 
# check content of My Shopping Cart block on Ho 


me page 
shopping cart icon = \ 
self.driver.find element by css selector 
("div.header-minicart span.icon") 
shopping cart icon.click() 


shopping cart status = \ 
self.driver.find element by css selector 
("p.empty").text 
self.assertEqual("You have no items in your sho 
pping cart.", shopping cart status) 


close button = self.driver.find element by css 
selector 
("div.minicart-wrapper a.close") 
close button.click() 


@classmethod 

def tearDown(cls): 
# close the browser window 
cls.driver.quit() 


def is element present(self, how, what): 
Utility method to check presence of an element 
on page 
:params how: By locator type 
:params what: locator value 


try: self.driver.find element(by-how, value=wha 


t) 
except NoSuchElementException, e: return False 
return True 
if name == ' main ': 


unittest.main(verbosity-2) 





我 们 将 用 TestSuite 类 来 定义 和 执行 测试 套件 。 
我 们 可 以 把 多 个 测试 加 入 到 一 个 测试 套件 中 去 。 除 
了 TestSuite 类 ， 我 们 还 可 以 用 TestLoader 和 
TextTestRunner 来 创建 和 运行 测试 套件 ， 举 例如 
ds 


import unittest 
from searchtests import SearchTests 
from homepagetests import HomePageTest 


# get all tests from SearchProductTest and HomePageTest 
class 

search tests - unittest.TestLoader().loadTestsFromTestC 

ase 

(SearchTests) 

home page tests = unittest.TestLoader().loadTestsFromTe 


stCase 
(HomePageTest) 


# create a test suite combining search test and home pa 
ge test 

smoke tests - unittest.TestSuite([home page tests, sear 
ch tests]) 


# run the suite 
unittest.TextTestRunner(verbosity-2).nrun(smoke tests) 





使 用 TestLoader 类 ， 我 们 将 得 到 指定 测试 文件 
中 的 所 有 测试 方法 且 用 于 创建 测试 套件 。 
TestRunner 类 将 通过 调用 测试 套件 来 执行 文件 中 所 
有 的 测试 。 


我 们 可 以 通过 下 面 的 命令 运行 新 的 测试 套件 文 
fF. 


python smoketests.py 


这 将 运行 ——— MM 


类 中 的 所 有 测试 并 且 通 过 命令 行 形式 生成 下 图 这 样 
的 测试 输出 。 


C:\Windows\system32\cmd.exe 





etests\chapter2>smoketests 
es t dp veis option s sni cn “ts . HomePageTest) 
es = earch_field (homepagetests.HomePageTest) ... ok 
2 ee cart_empty_message (homepagetests Se t) 
es eR ear ch_by _category (searchtests -SearchTest 
est_search_by_name (searchtests .SearchTests - rete ok 


sis 





2.2 ”生成 HTML 格 式 的 测试 报告 


unittest 在 命令 行 输出 测试 结果 。 你 可 能 需要 生 
成 一 个 所 有 测试 的 执行 结果 作为 报告 或 者 把 测试 结 
末 肥 给 相关 人 员 。 给 相关 人 员 发 送 命令 行 日 志 不 是 
一 个 明 乔 的 选择 。 他 们 需要 格式 更 加 友好 的 测试 报 
告 ， 既 能 够 全 看 测试 结果 的 概况 ， 也 能 够 深入 查看 
报告 细节 。unittest 没 有 相应 的 内 置 模块 可 以 生成 格 
式 友好 的 报告 ， 我 们 可 以 应 用 Wai Yip Tung 编 写 的 
unittest 的 扩展 HTMLTestRunner 来 实现 。 从 下 面 的 
网 址 可 以 获取 更 多 关于 HTMLTestRunner 的 信息 并 
可 以 下 载 说 明文 档 : 
https://pypi.python.org/pypi/HTMLTestRunner. 














HTMLTestRunner 扩 展 可 以 在 本 书 的 附件 
源 代码 中 找到 。 


| | 


我 们 将 在 测试 中 使 用 HTMLTestRunner 来 生成 
漆 膨 的 测试 报告 。 通 过 修改 在 本 半 前 面 涉及 的 测试 
套件 文件 来 添加 HTMLTestRunner 支 持 。 我 们 需要 
创建 一 个 包含 实际 测试 报告 的 输出 文件 ， 需 要 配置 
HTMLTestRunner 选 项 和 运行 测试 ， 具 体 如 下 。 





import unittest 

import HTMLTestRunner 

import os 

from searchtests import SearchTests 
from homepagetests import HomePageTest 


# get the directory path to output report file 
dir = os.getcwd() 


# get all tests from SearchProductTest and HomePageTest 
class 

search tests = unittest. TestLoader().loadTestsFromTestC 

ase(SearchTests) 

home page tests = unittest.TestLoader().loadTestsFromTe 

stCase(HomePageTest) 


# create a test suite combining search test and home pa 
ge test 

smoke tests - unittest.TestSuite([home page tests, sear 
ch tests]) 


# open the report file 


outfile = open(dir + "\SmokeTestReport.html", 


# configure HTMLTestRunner options 

runner = HTMLTestRunner.HTMLTestRunner ( 
stream-outfile, 
title-'Test Report', 
description='Smoke Tests' 


) 


# run the suite using HTMLTestRunner 
runner.run(smoke_tests) 


“w") 





执行 该 测试 套件 ，HTMLTestRunner 像 unittest 
的 默认 测试 执行 右 一 样 运 行 所 有 的 测试 。 在 用 例 执 
行 的 最 后 ， 它 将 生成 测试 报告 文件 ， 如 下 图 所 示 。 











/ Test Report x WM 
€ 2 e m file///C;/setests/chapter2/SmokeTestReport.html D »| = 
HI Apps (7j Selenium (7 Agile CJ Symantec C Testing (7j Apple/iOS (CJ Web » (7j Other bookmarks 











Test Report 


Start Time: 2014-09-08 11:26:39 
Duration: 0:01:51.986000 
Status: Pass 5 


Smoke Tests 


Show Summary Failed AII 


Test Group/Test case Count Pass Fail Error View 


test language option 
test search field pass 


test shopping cart empty message 


test search by category 








2.3 ”章节 回顾 


本 章 我 们 学 习 了 如 何 使 用 unittest 来 编写 和 运行 
基于 Selenium WebDriver 的 测试 脚本 。 我 们 使 用 包 
含 setUp0 方 法 和 tearDown0 方 法 的 TestCase 类 来 创建 
测试 。 我 们 还 可 以 添加 断言 来 验证 预期 结 末 和 实际 
结束 是 售 一 致 。 





我 们 也 学 习 了 如 何 使 用 unittest 支 持 的 不 同类 型 
的 断言 。 我 们 实现 了 测试 套件 ， 它 提供 了 把 不 同 的 
测试 用 例 组 成 逻辑 分 组 的 能 力 。 最 后 ， 我 们 使 用 
HTMLTestRunner 来 生成 格式 友好 的 HTML 格 式 的 
测试 报告 。 








在 下 一 章 中 ， 我 们 将 学 习 如 何 定 义 和 使 用 定位 
器 来 与 页 面 中 的 不 同类 型 的 HTML 元素 进行 交互 。 





第 3 章 JURE 


Web 应 用 以 及 包含 超 文本 标记 语言 
(HTML) 、 层 全 样式 表 (CSS) 、JavaScript 脚 本 
的 Web 页 面 ; 基于 用 户 的 操作 行为 诸如 跳 转 到 指定 
的 统一 资源 定位 URL) 网站， 或 是 单 击 提交 按 
钮 ， 浏 览 右 同 Web 服 务 占 发 送 请 求 ;，Web 服 务 器 啊 
应 请 求 ， 返 回 给 浏览 句 HIML 以 及 相关 的 
JavaScript. CSS. Arse ot; Wi as ae A Kk Ee VI 
源 生 成 Web 页 面 ， 其 中 包含 Web 各 种 视觉 元 素 ， 例 
如 文本 框 、 按 钮 、 标 签 页 、 图 表 、 复 选 枉 、 单 选 按 
钮 、 列 表 、 图 片 等 。 上 面 列举 的 这 些 ， 我 们 普通 用 
户 并 不 用 关心 ， 放 心 交 给 HTML 去 组 织 并 且 最 终 呈 
现在 浏览 右 里 即 可 。 这 些 视觉 元 又 或 控件 都 被 
Selenium J H HJC (WebElements) . 

















本 章 包含 以 下 主题 








。 理 解 更 多 Selenium WebDriver 定 位 元 素 的 方法 ; 
理解 利用 浏览 喜 开 有 者 便 式 辅助 定位 元 素 的 方 
法 ; 

定位 元 了 系 的 方法 包括 通过 ID 定 位 、name 定 位 、 
class 属 性 定位 以 及 利用 XPath 和 和 CSS 选择 占 定 

位 ; 

通过 各 种 find_element_by 的 方法 查找 元 素 ， 以 便 
使 用 Selenium WebDriver 与 之 目 动 化 交互 。 














当 我 们 想 让 Selenium 目 动 地 操作 我 们 的 浏览 
器 ， 残 必须 告诉 Selenium 如 何 去 定 位 某 个 元 素 或 一 
组 元 素 ， 可 以 通过 编程 的 方式 去 模拟 用 户 操作 。 
个 元 系 有 大 不 同 的 标签 名 和 属性 值 ，Selenium 提 供 
了 多 种 选择 与 定位 元 素 的 方法 。 











我 们 如 何 获取 这 些 信 息 呢 ? 大 家 都 知道 ，Web 
页 面 是 由 HIML、CSS 和 JavaScript 等 组 成 的 。 我 们 


可 以 通过 和 奋 看 页 面 源 文件 的 方式 了 解 这 些 文 本 信 
恩 ， 进 而 可 以 找到 我 们 想 要 的 tag 标 签 ， 了 解 与 之 对 
应 的 元 素 是 如 何 交 互 的 、 如 何 定义 属性 与 属性 值 
的 ， 以 及 页 面 的 结构 。 下 面 展示 了 一 个 我 们 正在 测 
试 的 场景 ， 这 是 一 个 常见 的 搜索 功能 ， 包 括 搜索 框 
与 搜索 按钮 放大镜 图 标 )〉。 











让 我 们 看 一 下 其 对 应 的 HTML 脚 本 。 





<form id="search_mini_form" action= 
"http: //demo.magentocommerce.com/catalogsearch/result 


method="get"> 
<div class="form-search"> 
«label for="search">Search:</label> 
«input id="search" type="text" name-"q" value=" 


class="input-text" maxlength="128" /> 
<button type="submit" title="Search" 
class="button" ><span><span>Search</span></spa 
n></button> 
<div id="search_autocomplete" class-"search- 
autocomplete"></div> 
<script type="text/javascript"> 


/ /« ! [CDATA[ 
var searchForm = new Varien.searchForm 
('search mini form', 'search', ‘Search en 
tire store 
here...'); 
searchForm.initAutocomplete 
('http://demo.magentocommerce.com 
/ catalogsearch/ajax/suggest/', 
'search autocomplete'); 
//]]> 
</script> 
</div> 
</form> 








我 们 发 现 类 似 搜 索 框 、 搜 索 按 钮 这 样 的 元 素 ， 
都 是 采用 内 骸 在 <form> 标 签 内 的 <input> 标 签 来 实 
现 ， 标 记 则 用 了 <label> 标 签 来 实现 。 另 外 ， 
JavaScript 代 码 写 在 了 <script> 标 俭 内 。 





其 中 搜索 框 <input> 标 签 中 包含 id、type、 
name、value、class 和 maxlength 属 性 的 定义 。 


<input id="search" type="text" name="q" Value= 





class="input-text" maxlength="128" /> 





我 们 可 以 在 浏览 器 窗口 右键 单 击 ， 在 快捷 菜单 


中 选择 查看 源 文件 选项 ， 在 弹出 的 窗口 中 可 以 显示 
HTML 文 件 与 JavaScript 脚 本 。 


如 果 你 对 查看 HTML、CSS 和 JavaScript 
感到 生 玻 的 话 ， 可 以 查看 相关 网 站 ， 可 以 帮 
助 你 更 快 地 识别 WebDriver 所 需 的 元 素 的 位 
置 。 





3.1 ”借助 浏览 器 开发 者 模式 定位 


在 使 用 Selenium 测 斌 之前， 我 们 通 单 会 先 去 得 
看 页 面 源 代码 ， 借 助 工 具 可 以 帮助 我 们 了 解 页 面 结 
构 。 值 得 庆 驻 的 是 ， 目 前 绝 大 多 数 的 浏览 器 都 内 置 
有 相关 插件 ， 能 够 快速 、 简 洁 地 展示 各 类 元 素 的 属 
性 定义 、DOM 结 构 、JavaScript 代 码 块 、CSS 样 式 等 
属性 。 接 下 来 我 们 一 起 学 习 这 类 工具 的 细 市 以 及 使 
HZr&. 








3.1.1 用 火狐 浏览 器 Firebug 插 件 检查 页 面 
TUR 

AT AAS ER] x a ms ES EA A DA IRE 77 T E 
具 ， 然 和 而， 我们 还 是 建议 大 家 使 用 功能 更 强大 的 
Firebug 插 件 。 


(1) 你 可 以 通过 下 列 地 址 ， 下 载 并 安装 
Firebug 插 件 。 


https://addons.mozilla.org/en- 
us/firefox/addon/firebug/ 


(2) 尝试 用 Firebug， 在 页 面 上 移动 鼠标 至 希 
望 获取 的 元 素 ， 然 后 右键 单 击 ， 弹 出 快捷 菜单 。 





(3) 选择 使 用 Firebug 人 查看 元 素 。 此 时 火狐 浏 
览 器 下 方 会 显示 HITML 代 码 树 窗口 并 定位 到 所 选 的 
元 素 上 ， 如 下 图 所 示 。 





M) Madison Island 


\ € «© demo.magentocommerce.com c S- Bin 
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Hy 4 > %= Console | HTML» | CSS Script DOM Net Cookies P Search bytextorCSS| ^| w | BBG 
lé» | Edit | * span.label < a.skip-li..-account < div.skip-links < Se .Ontainer < * | Style v | Computed Layout DOM Events > 
SXKIPp"SESIUII IIUI— preser segaren X 
B «a class-"skip-link 
skip-account" href="¢header-account"> 
<span class="icon"> </span> box-sizing: border-box; 
z a SRE margin: 0; 
</a> m = padding: 0; 
由 «div class-"header-minicart"» 
</div> 


C ae 


*:before, *:after styles.css (line 377) ^ 


， *:before, *:after styles.css (line 377) 


Up Tr ERES een gU" 





box-sizing: border-box; 


(4) 我 们 还 可 以 使 用 Firebug 的 XPath 或 CSS 选 
择 右 ， 通 过 Firebug 弹 出 窗口 目 带 的 检索 功能 ， 只 要 
BE A RAN ES, BLA DL TG ae PE ac 
的 元 素 ， 如 下 图 所 示 。 





X address.copyright 


= Console | HTML | CSS Script DOM Net Cookies 
* span.label < a.skip-li..-account < div.skip-links < div.page-...ontainer Style ~ | Computed Layout DO 


d lass="link ^ *, *:before, *:after styles 
d lass-"link t 
+ «div class-"links social-media"» box-sizing: border-box; 
© 2014 Madison Island. margin: G; 
padding: 0; 


3.1.2. HI SX Chrome? i zs en [I 765 2& 

谷歌 Chrome 浏 览 器 也 目 带 有 页 面 分 析 的 功能 。 
你 可 以 通过 以 下 步 驰 来 检查 页 面 元 素 。 

C1) 首先 移动 鼠标 光标 到 期 望 的 元 素 上 ， 然 
后 右键 单 击 ， 在 弹出 的 快捷 菜单 中 ， 选 择 检 查 
(N) 选项 。 

在 浏览 器 的 下 方 ， 将 显示 类 似 Firebug 的 开发 者 
工具 窗口 ， 如 下 图 所 示 。 
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Y «div id-"header-search" classs"skip-content"» 
Y «form id-"search mini form" action-"http://demo.magentocommerce.com/catalogsearch/result/" method-"get"» 
v (div class="input-box"> 


value class-"input-text required-entry" maxlength-"128" 
placeholder-"Search ent 
> <button type="submit" title-"Search" class="button search-button">..</buttor> 
::after 
</div> 
*top body div div #header div div#header-search.skip-content form#search_mini_form — divinput-box MENS TILES Eae e Ti RESTI zara 


m 
*| » 
| | Styles 
elemenl .slyHe f£ ~ 
|] 
mecia-"all" 
styles.css:3626 > 
5 





(2) 同样 类 似 Firebug， 当 我 们 需要 使 用 XPath 
或 CSS 选 择 右 时， 在 开发 者 工具 下 的 Elements 窗 口 
中 ， 按 Ctrl+F 键 ， 将 会 显示 搜索 框 。 一 旦 输入 XPath 
或 CSS 表 达 式 ，Firebug 就 会 高 亮 显示 与 之 匹配 的 元 


素 ， 如 下 图 所 示 。 


Q 日 | Elements | Network Sources Timeline Profiles Resources Audits Console 
> <div class= "links /div 
> «div clas links /div 
> «div Sunnie links ee muli ty cline 


</div> 

::after 

</div> 
#iop body div div #header div #header-search #search_mini_form § div.input-box EIS Tie 2szc eaaR Tie iid css] 
//addresd f1 SE Cancel 


3.1.3 ”用 下 浏览 器 检查 页 面 元 系 
RAW LIBI 4 AT AY EJ 
能 。 你 可 以 通过 以 下 步骤 来 检查 页 面 元 素 。 
(1) 按 F12 键 ， 在 浏览 器 下 方 显 示 开 发 者 工具 
窗口 。 


(2) 在 开发 者 工具 窗口 选择 “箭头 ”按钮 ， 然 
后 单 击 页 面 中 期 望 获取 的 元 素 ， 在 开发 者 工具 窗口 
将 高 亮 显 示 对 应 的 HTML 代 码 树 ， 如 下 图 所 示 。 
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通过 上 述 工具 ， 可 以 非常 有 效 地 帮助 我 们 编写 
测试 代码 ， 以 及 执行 与 调试 JavaScript 脚 本 。 


3.22 AEM 





我 们 必须 告诉 Selenium 怎 样 去 定位 元 素 ， 用 来 
模拟 用 户 动作 ， 或 者 但 看 元 系 的 属性 和 状态 ， 以 便 
我 们 可 以 执行 检查 。 例 如 ， 我 们 要 搜索 一 个 产品 ， 
首先 要 找到 搜索 框 与 搜索 按钮 ， 接 着 通 过 键盘 和 输入 
要 程 询 的 关键 字 ， 最 后 用 鼠标 单 击 搜索 按钮 ， 提 和 区 
搜索 请 求 。 














正如 上 述 人 工 的 操作 步骤 一 样 ， 我 们 也 和 希望 
Selenium 能 模拟 我 们 的 动作 ， 然 而 ，Selenium 并 不 
能 理解 类 似 在 搜索 框 中 输入 关键 字 或 单 击 搜索 投 钮 
这 样 图 形 化 的 操作 。 上 所 以 需要 我 们 程序 化 地 告诉 
Selenium 如 何 定 位 搜索 框 与 搜索 按钮 ， 从 而 模拟 键 
盘 与 鼠标 的 动作 。 





Selenium 提 供 多 种 find_element_by 方法 用 于 定 
位 页 面 元 素 。 这 些 方 法 根据 一 定 的 标准 去 租 找 元 


素 ， 如 果 元 素 被 正常 定位 ， 那 么 WebElement 实 例 将 
返回 。 反 之 ， 将 抛 出 NoSuchElementException 的 异 
第 。 同 时 ，Selenium 还 提供 多 种 find_elements_by 方 
法 去 定位 多 个 元 素 ， 这 类 方法 根据 所 匹配 的 值 ， 搜 
索 并 返回 一 个 list 数 组 〈 元 素 ) 。 





Selenium 提 供 8 种 find_element_by 方法 用 于 定 





位 元 素 。 接 下 来 的 部 分 ， 我 们 将 逐一 介绍 方法 细 
T. D XB. 




































find element by. id(id) EE id: 元 素 的 ID | driver.find_element_by_id('search') 





find_element_by_name(name) driver.find_element_by_name(‘q') 














过 元 
素 的 
class 名 |name: 元 素 





E 


find_element_by_class_name(name) driver.find_element_by_class_name('i 


来 定位 | 的 类 名 
元 素 









name: tag . 
find element by tag name(name) driver.find element. by. tag name('in] 
name 














XPath: JU zR 
find element by xpath(xpath) Pat driver.find_element_by_xpath('//form| 
? at 





Css selector: 


find element by css selector(css selector) 来 | 元 素 的 CSS 选 driver.find_element_by_css_selector(' 
Peas 














link text: X 
本 信息 


find_element_by_link_text(link_text) driver.find_element_by_link_text('Lo; 











素 标签 


对 之 间 | link text: 部 
find_element_by_partial_link_text(link_text) 的 部 分 | 分 文本 信息 driver.find_element_by_partial_link_t 


文本 信 


BORE 
位 元 素 





find elements by 方法 能 按照 一 定 的 标准 返回 
































mo dl 

find_elements_by_id(id_) ~ driver.find_elements_by_id(‘product' 
name: 元 素 

find_elements_by_name(name) E driver.find elements by name('prod 





的 name 





| class 名 |name: 元 素 
find_elements_by_class_name(name) driver.find_elements_by_class_name 


来 定位 | 的 类 名 


find_elements_by_tag_name(name) driver.find elements by tag name(* 


XPath: 元 素 
find_elements_by_xpath(xpath) BUXPath driver.find elements by xpath("//div 
` at 


css_selector: 





find_elements_by_css_selector(css_selector) JCA HICSS | driver.find elements by. css selecto: 


Tid 





素 标签 
对 之 间 


| | i : MMA]. 
find_elements_by_link_text(text) 的 文本 driver.find_elements_by_link_text('L 


信息 来 





定位 一 


组 元 素 





素 标签 
对 之 间 


find elements by. partial link text(link text) | 的 部 分 |link_text: 部 |driver.find elements by. partial link 











文本 信 | 分 文本 信息 
AKE 

位 一 组 

TUR 





3.2.1 ID 定位 





通过 I 有 DD 但 找 元 系 是 查找 页 面 上 元 素 的 最 佳 方 
法 。find_element_by_id() 和 find_elements_by_id() 方 
法 返回 与 ID 属性 值 匹 配 的 一 个 元 素 或 一 组 元 素 。 


find_element_by_id0) 方 法 返回 的 是 与 ID 属性 值 
LERES, WRA NASZA, WHAE 


NoSuchElementException = 5$ o 


a FÉ. FRAT SS OR cE I BATE 


通过 查看 HTML， 我 们 可 以 看 到 搜索 框 的 ID 值 
被 定义 为 search 。 


<input id="search" type="text" name="q" value="" 





class="input-text" maxlength="128" autocomplete="off"> 


接 下 来 我 们 使 用 find_element_by_id0) 方法 ，id 
值 为 search 来 定位 搜索 框 ， 同 时 检查 maxlength 的 属 
PEE - 


def test_search_text_field_max_length(self): 
# get the search textbox 
search_field = self.driver.find_element_by_id("search 


") 


# check maxlength attribute is set to 128 
self.assertEqual("128", search field.get attribute("m 
axlength")) 





此 外 ， 如 果 使 用 find_elements_by_id0 方法 ， 
那么 将 返回 匹配 ID 值 的 所 有 元 素 。 


3.2.2 name 定位 


通过 name 定 位 是 男 外 一 个 常用 的 查找 元 系 的 方 
式 。find_element_by_name() 和 
find_elements_by_name(0) 方 法 可 以 通过 匹配 name 值 


来 定位 单个 或 一 组 元 素 。 同 样 ，name 值 匹配 成 功 可 
返回 定位 的 元 素 ; 及 之 ， 则 抛 出 
NoSuchElementException H] 3% o 





回 到 之 前 的 例子 ， 我 们 可 以 用 匹配 name 属 性 值 
的 方式 来 瞧 换 ID 值 的 匹配 ， 同 样 可 以 定位 到 搜索 
框 。 





此 外 ， 如 果 使 用 find_elements_by_name0) 77 
法 ， 那 么 将 返回 匹配 name 值 的 所 有 元 素 。 


3.2.3 class 


除了 使 用 ID 和 name 属 性 ， 我 们 还 可 通过 class 属 
性 来 定位 元 素 。class 用 来 天 联 CSS 中 定义 的 属性 。 
find_element_by_class_name() 和 


find_elements_by_class_name() 方 法 可 以 通过 [匹配 














class 属 性 来 定位 单个 或 一 组 元 素 。 同 样 ，class 值 匹 
配 成 功 可 返回 定位 的 元 素 ; 反之 ， 则 抛 出 
NoSuchElementException fy F743 





通过 对 元 素 ID、name 和 class 属 性 来 查找 
元 素 是 最 为 普 过 和 快捷 的 方法 。 此 外 ， 
Selenium WebDriver 还 提供 了 其 他 一 些 方法 用 
于 定位 元 素 ， 在 接 下 来 的 段落 中 会 有 详细 介 


绍 。 














同样 的 场景 ( 见 下 图 〉， 我 们 可 以 笑 试 用 
find_element_by_class_name() 的 方法 来 定位 元 素 。 








搜索 按钮 〈 放 大 镜 图 标 ) 在 HIML 中 是 用 
«button» $5 2x (JCR) 以 及 对 应 的 class 属 性 与 属性 


值 定 义 的 ， 有 共 体 如 下 。 


<button type="submit" title="Search" 


class="button" ><span><span>Search</span></span></butt 
on> 








下 面 我 们 用 class 属 性 值 来 定位 搜索 按钮 ， 代 码 
如 下 。 


def test search button enabled(self): 

# get Search button 

search button = self.driver.find element by class n 
ame 


("button") 


# check Search button is enabled 
self.assertTrue(search button.is enabled()) 





Jt5h. ünRfHjfind elements by class name() 
方法 ， 那 么 将 返回 匹配 class 属 性 值 的 所 有 元 素 。 


3.2.4 _ tag 定位 


find_element_by_tag_name() 和 
find_elements_by_tag_name() 方法 是 通过 对 HTML 


页 面 中 tag name 匹 配 的 方式 来 定位 元 素 的 。 这 些 方 
法 跟 JavaScript 中 的 DOM 方 法 getElementsBy 
TagName() 类 似 。 同 样 ， 通 过 成 功 匹 配 tag namen] UJ 
返回 定位 的 元 系 ; 反之 ， 则 抛 出 


NoSuchElementException' F # © 


这 个 方法 在 某 些 特定 的 场景 下 格外 有 用 ， 例 
如 ， 我 们 可 以 通过 <tr> 的 tag name 一 次 定位 页 面 的 
table PATA HITE (OCR) 。 


如 下 图 所 示 的 几 张 banner 图 ， 通 过 查看 HTML 
代码 ， 我 们 可 以 看 出 包含 有 <img> 或 者 <ul> 的 标 


HOME & DECOR [Mm SHOP PRIVATE SALES | TRAVEL GEAR 
FOR ALL YOUR SPACES HI MEMBERS ONLY FOR EVERY OCCASION 


iX JULsKbanner KH ZG FE A] & ES <ul> A tk A 
像 标 签 <img> 来 实现 。 


<ul class="promos"> 


<li> 
«a href="http://demo.magentocommerce.com/home-dec 
or.html"» 
«img src="/media/wysiwyg/homepage-three-colum 


n-promo- 
O1B.png" alt="Physical & amp; Virtual Gift 
Cards"» 
«/a» 
«/li» 
«li» 
«a href="http://demo.magentocommerce.com/vip.html 
"> 
<img src="/media/wysiwyg/homepage-three-colum 
n-promo- 
02.png" alt="Shop Private Sales - Members O 
nly"> 
</a> 
</li> 
<li> 


<a href="http://demo.magentocommerce.com/accessor 
ies/ bags-luggage.html"» 
<img src="/media/wysiwyg/homepage-three-colum 
n- 
promo-@3.png" alt="Travel Gear for Every Oc 


casion"> 
</a> 
</li> 
</ul> 








我 们 使 用 find_elements_by_tag_name() 方 法 来 定 
位 所 有 的 banner 图 请。 首先 我 们 用 


find_element_by_class_name() 方 法 定位 这 一 组 banner 


图 ， 然 后 用 find_elements_by_tag_name() 方 法 去 匹配 
<img> 的 tag name， 最 后 把 结果 返回 给 banners 对 
象 。 





def test count of promo banners images(self): 

# get promo banner list 

banner list - self.driver.find element by class nam 
e("promos") 


# get images from the banner list 
banners - banner list.find elements by tag name("im 


g") 


# check there are 20 tags displayed on the page 
self.assertEqual(2, len(banners)) 





3.25 “XPath 定位 





XPath 古 一 种 在 XML 文 档 中 搜索 和 定位 元 系 的 
查询 语言 。 几 乎 所 有 ii 浏览 器 都 支持 XPath。 同 
样 ，Selenium 也 可 以 通过 XPath 的 方式 在 web 页 面 上 
定位 元 素 。 








当 我 们 发 现 通 过 ID、name 或 class 属 性 值 都 无 法 





定位 元 素 时 ， 不 妨 答 试用 XPath 的 方式 。 我 们 可 以 
灵活 地 运用 绝对 或 相对 路 径 定 位 ， ee 
ID、 他 属性 来 定位 ， 甚 至 还 可 以 通 
属性 值 的 一 部 分 (如 starts-with()、 cast 
with()) incline 














了 解 更 多 关于 XPath 的 知识 ， 可 访问 相关 








想 要 了 解 更 多 关于 XPath 定位 的 知识 ， 可 以 参 
考 《Selenium Testing Tools Cookbook) , Packt 
Publishing. 


fe PORK, FRAT AT Ef Hjfind element by. xpath() 
ffind elements by xpath() 方法 来 定位 元 素 了 。 例 
如 ， 我 们 通过 之 前 的 广告 banner 图 ， 单 击 banner 图 











上 亡 进 入 对 应 的 页 面 。 


MEMBERS ONLY 








上 图 是 名 为 “Shop Private Sales” 的 banner 图 ， 在 
<img> 的 tag 下 ， 其 中 代码 并 不 包含 ID、name 或 
class 属 性 等 信息 ， 且 这 个 页 面 还 包含 很 多 其 他 的 
<img>， 所 以 我 们 不 能 通过 传统 的 方法 如 findby 
tag_name() 简 单 地 定位 了 。 





<ul class="promos"> 
«li» 
«a hrefz"http: //demo.magentocommerce.com/vip.html 
«img src="/media/wysiwyg/homepage-three-column 
promo-02.png" alt="Shop Private Sales - Memb 
ers Only"> 


</a> 
</li> 


</ul> 





我 们 尝试 使 用 find_element_by_xpath() 方 法 ， 用 


<img> 标 签 下 的 alt 属性 值 来 定位 我 们 要 找 的 元 素 。 


代码 如 下 。 


def test vip promo(self): 
# get vip promo image 
vip promo = self.driver.\ 
find element by xpath("//img[(Qalt-'Shop Private Sa 
les - Members Only']") 


# check vip promo logo is displayed on home page 
self.assertTrue(vip promo.is displayed()) 

# click on vip promo images to open the page 

vip promo.click() 

# check page title 

self.assertEqual("VIP", self.driver.title) 





Wea, ün4EHjfind elements by. xpath() 77 
法 ， 那 么 将 返回 匹配 XPath 查询 到 的 所 有 元 素 。 


3.2.6 CSS 选择 器 定位 





CSS (JARAK) 是 一 种 用 于 页 面 设计 
(HTML) 与 表现 的 文件 样式 ， 是 一 种 计算 机 语 
言 ， 能 灵活 地 为 页 面 提 供 各 种 样式 风格 。CSS 使 用 





we TE ds YA os A Ee JE CHID, class. types 


attribute. value% ) 。 


XPath, Seleniumt, Ay LAA FACSS we RAS HY 
特性 ， 用 于 帮助 我 们 来 定位 元 素 。 如 果 想 进一步 了 
解 关 于 CSS 选 择 器 的 一 些 知 识 ， 请 访问 相关 网 站 了 


A. 





= 
Mi 


Fifi4rzBfind element. by css selector() 4l 
find elements by. css. selector() P $$ 77 3; © 


回 到 首页 的 例子 ， 可 以 看 到 购物 车 按钮 ， 单 击 
这 个 按钮 ， 将 进入 购物 车 页 面 。 如 果 此 时 没有 添加 
任何 商品 ， 那 么 系统 会 提示 “你 还 没有 添加 商品 到 
购物 车 "， 如 下 图 所 示 。 





HTML 代 码 如 下 。 


<div class="minicart-wrapper"> 
<p class="block-subtitle"> 

Recently added item(s) 

<a class="close skip-link-close" href="#" title-"Cl 
ose"> 


x«/a» 
«/p» 
«p class-"empty"»You have no items in your shopping 
cart. 
«/p» 
</div> 











dA BCE PRBS SEAM A. Hoc 
BATE CSS 6 PESROK GE MY Te, FAS LS. 
击 它 ， 紧 接着 定位 即将 弹出 的 信息 。 





def test shopping cart status(self): 
# check content of My Shopping Cart block on Home p 


age 
# get the Shopping cart icon and click to open the 
# Shopping Cart section 
shopping cart icon = self.driver.\ 
find element by css selector("div.header-minicar 
t span.icon") 
shopping cart icon.click() 


# get the shopping cart status 
shopping cart status = self.driver.\ 


find element by css selector("p.empty").text 
self.assertEqual("You have no items in your shoppin 
g cart.", shopping cart status) 
# close the shopping cart section 
close button = self.driver.\ 
find element by css selector("div.minicart-wrapp 
er a.close") 
close button.click() 





从 上 面 的 测试 脚本 可 以 看 出 ， 我 们 使 用 了 元 素 
tag 和 class name 来 缩小 获取 购物 车 按钮 的 范围 。 





shopping cart_icon = self.driver.\ 


find element by css selector("div.header-minicar 
t span.icon") 





首先 定位 到 tag 名 为 <div> 的 元 素 ， 然 后 接 
者 “.header-minicart” 的 类 名 ， 其 下 面 的 标签 <span> 
FMA “icon” NAA © 





想 要 了 解 更 多 基于 CSS 选 择 硕 的 知识 ， 请 参考 
«Selenium Testing Tools Cookbook) , Packt 
Publishing. 


3.2.7 Link fir 


find_element_by_link_text() 和 
find_elements_by_link_text() 方 法 是 通过 文本 链接 来 
定位 元 素 。 如 下 示例 。 





(1) 定位 首页 上 的 Account 链 接 ， 如 下 图 所 
示 ， 我 们 可 以 使 用 find_element_by_link_text() 方 
VF. 





(2) 查看 对 应 的 HITML 人 代码， 具体 如 下 。 





<a href="#header-account" class="skip-link skip-account 
"> 


<span class="icon"></span> 
<span class="label">Account</span> 
</a> 











(3) 编写 测试 脚本 ， 先 通过 文本 定位 Account 
链接 ， 然 后 单 击 伍 看 是 人 否 能 显示 。 











def test my account link is displayed(self): 
# get the Account link 
account link = 


self.driver.find element by link text("ACCOUNT") 


# check My Account link is displayed/visible in 
# the Home page footer 
self.assertTrue(account link.is displayed()) 





Hyh, ünfHjfind elements by link text()77 
WE. ARAKI [a] VO OSCAR] 7638 - 


3.2.8 Partial link 定 位 


find_element_by_partial_link_text() 和 和 
find_elements_by_partial_link_text() 两 个 方法 是 通过 
文本 链接 的 一 部 分 文本 来 定位 元 素 的 方法 。 如 下 示 
例 。 





(1) 同样 是 首页 ， 有 两 个 链接 可 以 得 看 个 人 
账户 (Account) 页 面 ， 一 个 是 页 面 标 头 〈header) 
部 分 的 Account 文 字 链 接 ， 另 外 一 个 是 页 脚 
(footer) 部 分 的 My Account L FER. 





(2) 我 们 使 用 


find elements by. partial link text()77 35, MIET 
文本 信息 *Account" 来 定位 ， 验 证 页 面 中 的 两 个 文本 
链接 是 否 都 能 定位 到 《〈 上 断言 ) 。 代 码 如 下 。 








def test_account_links(self): 
# get the all the links with Account text in it 
account_links = self.driver.\ 
find elements by partial link text("ACCOUNT") 


# check Account and My Account link is displayed/vi 
sible in the Home page footer 
self.assertTrue(2, len(account links)) 





3.3 a RR 


通过 前 面 的 介绍 ， 我 们 尝试 了 很 多 种 关于 
find_element_by 的 方法 。 接 下 来 我 们 把 这 种 类 型 的 
定位 方法 集成 到 同一 个 测试 脚本 中 来 。 





(1) 创建 一 个 名 为 homepagetest.py 的 Python 脚 
本 ， 整 合 之 前 我 们 创建 的 那些 测试 代码 。 





import unittest 
from selenium import webdriver 


class HomePageTest(unittest.TestCase): 
@classmethod 
def setUpClass(cls): 
# create a new Firefox session 
cls.driver = webdriver.Firefox() 
cls.driver.implicitly wait(30) 
cls.driver.maximize window() 


#navigate to the application home page 
cls.driver.get('http://demo.magentocommerce.com/ 


def test search text field max length(self): 
# get the search textbox 
search field - self.driver. 


te 


def 


def 


def 


def 


find element by id("search") 


# check maxlength attribute is set to 128 
self.assertEqual("128", search field.get attribu 


("maxlength")) 


test search button enabled(self): 
# get Search button 
search button = self.driver. 
find element by class name("button") 


# check Search button is enabled 
self.assertTrue(search button.is enabled()) 


test my account link is displayed(self): 

# get the Account link 

account link - 
self.driver.find element by link text("ACCOUNT 


# check My Account link is displayed/visible in 
# the Home page footer 
self.assertTrue(account link.is displayed()) 


test account links(self): 
# get the all the links with Account text in it 
account links = self.driver.\ 

find elements by partial link text("ACCOUNT") 


# check Account and My Account link is 
# displayed/visible in the Home page footer 
self.assertTrue(2, len(account links)) 


test count of promo banners images(self): 
# get promo banner list 


banner_list = self.driver. 
find element by class name("promos") 


# get images from the banner list 
banners - banner list. 
find elements by tag name("img") 


# check there are 3 banners displayed on the pag 
self.assertEqual(2, len(banners)) 


def test vip promo(self): 
# get vip promo image 
vip promo = self.driver. \ 
find_element_by_xpath("//img[@alt= 
‘Shop Private Sales - Members Only']") 


# check vip promo logo is displayed on home page 


self.assertTrue(vip promo.is displayed() ) 

# click on vip promo images to open the page 
vip_promo.click() 

# check page title 

self .assertEqual("VIP", self.driver.title) 


def test shopping cart status(self): 
# check content of My Shopping Cart block 
it on Home page 
# get the Shopping cart icon and click to 
# open the Shopping Cart section 
shopping cart icon = self.driver.\ 

find element by css selector("div.header- 
minicart span.icon") 

shopping cart icon.click() 


# get the shopping cart status 
shopping cart_status = self.driver. \ 

find element by css selector("p.empty").text 
self.assertEqual("You have no items in your shop 


ping 

cart.", shopping cart status) 

# close the shopping cart section 

close button = self.driver.\ 
find element by css selector("div.minicart- 
wrapper a.close") 

close button.click() 

@classmethod 


def tearDownClass(cls): 
# close the browser window 
cls.driver.quit() 


if name == ' main ': 
unittest.main(verbosity-2) 








(20 你 存 py 文 件 ， 可 以 在 命令 行 中 直接 执 


python homepagetest .py 





(3) 执行 测试 过 程 中 ，unittest 会 打印 7 组 测试 
的 执行 结果 〈OK) ， 如 下 图 所 示 。 


s\chapter 3> 
ae. links 


int_of_promo_ banners . HomePageT 
account link is display _ „HomePage 
_.HomePa ageTest) 


__main__ 
rch_button_enabled ( 
—Sear ch -text -field_ max_le 


__main__.HomePageT 


-HomePageTest) 
vip_promo = 





3.4 BTM 


在 本 章 ， 我 们 一 起 学 习 了 许多 重要 的 Selenium 
定位 元 素 的 方法 。 使 用 find_element_by 方 法 ， 通 过 
ID. name. class name. tag name, XPath, CSS% 
Fea UA AEB. CBU) 去 定位 元 素 。 











在 后 续 设 计 测 试 时 ， 可 以 更 灵活 地 去 运用 这 些 
定位 的 策略 。 这 些 知识 为 接 下 来 的 革 节 ， 如 何 调用 
Selenium APIR% J tE. 





Roe, TEE] HEH Selenium 
WebDriver 的 功能 去 与 定位 到 的 元 素 交 互 ， 以 及 模 
拟 用 户 的 操作 例如， 在 文本 框 输入 、 单 击 按钮 、 
选择 下 拉 菜 单 、 调 用 JavaScript 等 操作 ) 。 








第 4 章 Selenium Python API 
TE 


Web 应 用 程序 通过 HTML 表 单 的 形式 把 数据 发 
送 到 服务 端 。HTML 表 单 中 的 输入 元 素 包 含 文本 
框 、 复 选 杠 、 单 选 框 和 提交 按钮 等 。 一 个 表单 也 可 
以 包含 下 拉 列 表 、 文 本 域 、 插 图 和 标签 等 元 素 。 


一 个 典型 的 Web 应 用 程序 从 注册 用 户 或 搜索 产 
品 开始 ， 往 往 需 要 填写 很 多 的 表单 信息 。 表 单 是 内 
嵌 在 HIML 代 码 的 <form> 标 签 里 的 。 标 签 中 指定 了 
提交 数据 的 方法 ， 可 以 使 用 GET 和 POST 方法 ， 输 
入 到 表单 请 求 的 地 址 就 是 我 们 要 提交 数据 的 服务 器 
地 址 。 


本 章 包含 以 下 主题 


。 更 多 地 了 解 WebDriver 和 WebElement 这 两 个 
K; 

。 使 用 WebDriver 和 WebElement 的 方法 来 实现 包含 
与 Web 应 用 程序 交互 的 测试 ; 

。 使 用 Select 类 来 实现 下 拉 末 单 和 列表 的 自动 化 操 
VE; 

e 实现 JavaScript Z E fI Và ds STE Bath. 





41 _ HTML 表单 元 素 





HTML 表 单 是 由 不 同类 型 的 元 素 组 成 的 ， 如 下 
图 所 示 包 含 <form>、<input>、<button> 和 <label> 等 
元 素 。Web 应 用 开发 者 通过 使 用 这 些 元 系 来 实现 数 
据 的 展示 和 接收 用 户 的 数据 提交 。 开 友人 员 通 过 定 
义 这 些 元 素来 编写 Web 页 面 的 HTML 代 码 。 然 而 作 
为 终端 用 户 ， 我 们 看 到 的 这 些 元 素 是 通过 诸如 文本 
杠 、 标 签 、 按 钮 、 复 选 框 和 单 选 按钮 的 形式 展现 出 
来 的 。HTML 代 码 对 于 终端 用 户 来 说 是 不 可 见 的 。 





Head <HEAD> Tile «TITLE= 




















| Tot 
/ Password. 
| Input <INPUT= | INR 
I \ Radio 
"TEN | | X. File 
( HTML. «HITML» ) |  Texarea <TEXTAREA>= 
— SSS Select <SELECT= Option <OPTION> 
Header <THEAD= 
\ Table / Body <TBODY~ 
M Rows «TR» Columns/Cells «1D 


\ Headings «H1», «H2» 
_Anchor <A> 





Selenium WebDriver 为 “实现 通过 与 这 些 Web 元 
素 的 交互 的 自动 化 来 验证 Web 程 序 的 功能 正确 
性 ”提供 了 强大 的 支持 。 


4.2 WebDriver/5 T£ 


WebDirver 提 供 许多 用 来 与 浏览 器 交互 的 功能 
和 设置 。 我 们 可 以 通过 使 用 WebDirver 的 功能 和 一 
些 方法 来 实现 与 浏览 嚣 窗口、 敬告、 框架 和 弹出 窗 
口 的 交互 。 它 也 提供 了 自动 化 操作 浏览 器 导航 栏 、 
设置 cookies、 截 屏 等 方便 我 们 测试 的 特性 。 在 后 面 
的 章节 中 ， 我 们 将 依次 阐述 这 些 WebDirver 的 重要 
特性 。 本 节 的 表格 中 包含 了 一 些 将 在 本 书后 面 章 市 
中 使 用 到 的 非常 重要 的 功能 和 方法 。 











— 
NS 





在 下 面 的 网 址 可 以 看 到 完整 的 WebDirver 
的 properties 和 方法 列表 。 


http://selenium.googlecode.com/git/docs/ap 
i/py/webdriver remote/selenium.webdriver.remo 


te.webdriver.html#moduleselenium.webdriver.re 


mote.webdriver 





4.2.1 WebDriver 功 能 


WebDriver 通 过 下 表 的 功能 来 操纵 浏览 器 。 
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4.2.2 WebDriver7; i7: 








WebDirver 通 过 一 些 方法 来 实现 与 浏览 器 窗 
网 页 和 页 面 元 素 的 交互 。 下 表 是 一 些 重要 的 广 


























后 退 一 步 到 当前 会 














a 


话 的 浏览 器 历史 记 
录 中 最 后 一 步 操作 


back() 














前 的 页 面 


2 
前 进一步 到 当前 会 
话 的 浏览 器 历史 
forward() 录 中 前 一 步 操作 
的 页 面 
访问 目标 URL3 
get(url) 载 网 页 到 当前 的 
览 器 会 话 






































窗 





Z 
id 
后 





加 
浏 





最 大 化 当前 浏览 器 


maximize_window() zm 
窗口 








退出 当前 driver 并 且 


quit() 关闭 所 有 的 相关 

















BS 


向 








driver.back() 


= driver.close() 


driver.forward() 











URL 是 目标 网 
页 的 网 站 地 址 











driver.get("http://www.googl 


driver.maximize_window() 


driver.quit() 


refresh() 


switch_to_active_element() 


switch_to_alert() 


switch_to_default_content() 


switch_to-frame(frame_reference) 


switch_to_window(window_name) 


implicitly_wait(time_to_wait) 





新 当前 页 面 

















出 的 警告 














切换 焦点 至 默认 框 


Zn 


nm 


38 
网 




















架 内 


过 索引 、 名 称 和 





页 元 素 将 焦点 切 
| 指定 的 框架 ， 














方法 也 适用 于 





IFRAMES 


切换 焦点 到 指定 的 


窗 


超 


元 素 被 找到 ， 或 者 


A 


时 设置 等 待 目标 














目标 指令 执行 完 


成 。 


该 方法 在 每 个 





session 只 需要 调用 


一 次 。 


execute_async_script 





frame_reference: 
要 切换 的 目标 
窗口 的 名 称 、 
整数 类 型 的 索 
引 或 者 要 切换 
的 目标 框架 的 
网 页 元 素 
































window_name: 
目标 
尔 或 



































time_to_wait: 等 


待 时 间 (单位 
Ab 























driver.refresh() 


driver.switch to active elem 


driver.switch to alert() 


driver.switch to default cor 


driver.switch to frame(' fram 


driver.switch to window('m 











的 超时 设置 ， 请 参 
阅 set_script_timeout 


方法 

















设置 一 个 页 面 完 全 |jtime to wait: 等 
set page load timeout(time to wait) | 加 载 完 成 的 超时 等 | 待 时 间 (单位 ”| driver.set_page_load_timeou 
待 时 间 为 秒 ) 























设置 脚本 执行 的 超 "m 


i z time_to_wait: = 
Sy | 时 时 间 , 应 该 在 P| Mu 
set script timeout(time to wait) 待 时 间 CAAA —|driver.set. script. timeout(30) 
execute async script | , 
为 秒 ) 


抛 出 错误 之 前 























43 WebElement# O 





我 们 可 以 通过 WebElement 实 现 与 网 站 页 面 上 的 
元 素 的 交互 。 这 些 元 素 包 含 文本 杠 、 文 本 域 、 按 
钮 、 单 选 枉 、 多 选 枉 、 表 格 、 行 、 列 和 div 等 。 





WebElement 提 供 了 一 些 功能 、 属 性 和 方法 来 实 
现 与 网 页 元 素 的 交互 。 本 节 的 表格 中 将 列 出 后 面 章 
节 会 用 到 的 一 些 重要 的 功能 和 方法 。 如 果 想 僵 看 完 
整 的 功能 和 方法 详情 ， 请 访问 以 下 网 站 。 














http://selenium.googlecode.com/git/docs/api/py/we 


selenium.webdriver.remote.webelement 


4.3.4 WebElement 2 sé 


下 面 是 WebElement 功 能 列表 。 
































size 获取 元 素 的 大 小 element.size 


tag_name 获取 元 素 的 HTML 标 签名 称 element.tag_name 


获取 元 素 的 文本 值 element.text 





4.3.2 WebElementJ7; i: 


下 面 是 WebElement 方 法 列表 。 


clear() | ae element.clear() 
文本 域 中 的 内 容 
单 击 元 element.click() 


element.get_attribute("Vvalue") 





















































get_attribute(name) ^ 或 者 

















element.get. attribute("maxlength") 


检查 元 素 对 于 用 
is_displayed() B element.is displayed() 
户 是 否 可 见 


is_enabled() B element.is enabled() 


检查 元 素 是 否 被 


























is_selected() 


send_keys(*value) 


submit() 


value_of_css_property 


(property_name) 


eA 








P. 该 方法 应 


用 于 复 选 框 和 单 


选 按钮 


value: 待 输入 


模拟 输入 文本 





用 于 提交 表单 。 


的 字符 串 




















如 果 对 一 个 元 素 
应 用 此 方法 ， 将 
会 提交 该 元 素 所 








获取 CSS 











值 

















属 的 表单 








属性 的 | property_name: 








属性 的 名 称 





element.is_selected() 


element.send_keys("foo") 


element.submit() 


element.value_of_css_property 


("backgroundcolor") 





44 操作 表单 、 文 本 框 、 复 选 枉 、 单 选 
按钮 


我 们 可 以 使 用 WebElement 实 现 与 各 种 HTML 控 
件 的 目 动 化 交互 ， 例 如 在 一 个 文本 框 输入 文本 、 单 
击 一 个 按钮 、 选 择 单 选 按钮 或 者 复 选 枉 、 获 取 元 叉 
的 文本 和 属性 值 等 。 





在 前 面 的 章节 可 以 看 到 WebElement 提 供 的 功能 
和 方法 。 在 本 节 中 ， 我 们 将 使 用 WebElement 及 其 功 
能 和 方法 实现 在 样 例 程序 中 创建 账户 功能 的 目 动 
化 。 接 下 来 我 们 创建 一 个 测试 脚本 ， 来 验证 被 测 程 
序 是 否 能 正确 创建 一 个 新 的 账户 。 我 们 将 按照 下 图 
来 填写 表单 信息 并 且 提 交 请 求 ， 系 统 收 到 请 求 后 应 
该 创建 一 个 新 的 账户 。 





CREATE AN ACCOUNT 


First Name * 

| 
Last Name * 

Email Address * 

Password * 


Confirm Password * 


Sign Up for Newsletter 


Back REGISTER 


正如 在 上 图 看 到 的 ， 我 们 需要 填写 5 个 文本 框 
并 且 选 择 一 个 复 选 框 。 


(1) 首先 ， 创 建 一 个 新 的 测试 类 
RegisterNewUser， 下 面 是 实例 代码 。 


from selenium import webdriver 
import unittest 


class RegisterNewUser(unittest.TestCase): 
def setUp(self): 
self.driver = webdriver.Firefox 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 





(2) 添加 一 个 测试 方法 
test register new. user(self) 到 RegisterNewUser 类 


"p. 


(30 为 了 打开 登录 页 面 ， 我 们 需要 单 击 主页 
的 登录 链接 。 用 于 登录 的 代码 如 下 。 


def test register new user(self): 
driver - self.driver 


# click on Log In link to open Login page 
driver.find element by link text("Log In").click() 





4.4.1 RETA ER JHR 
当 元 素 在 屏幕 上 可 见 的 时 候 〈visible 属 性 设置 


XTRUE) ， 调 用 is_displayed0) 方法 返回 为 TRUE， 
反之 融会 返回 FALSE。 关 似 地 ， 当 元 素 是 可 用 的 时 
候 ， 调 用 is_enabled0 方法 返回 为 TRUE， 这 时 用 户 
残 可 以 执行 点 击 和 输入 文本 等 操作 。 当 元 素 是 不 可 
用 的 时 候 ， 访 方法 返回 FALSE。 

















用 户 登 录 页 面 提供 了 使 用 己 有 账户 登录 和 创建 
新 用 户 的 选项 。 我 们 可 以 通过 调用 is_displayed() 方 
法 和 is_enabled() 方 法 检查 创建 新 账户 按钮 对 于 用 户 
是 否 可 见 并 且 可 用 。 添 加 下 面 的 代码 到 测试 类 中 。 
# get the Create Account button 
create account button = driver.find element by x 
path("// 


button[@title='Create an Account']") 


# check Create Account button is displayed and e 
nabled 


self.assertTrue(create account button.is display 
ed() and 


create account button.is enabled( 


)) 





我 们 要 测试 创建 账户 功能 ， 因 此 要 单 击 创建 账 


户 按 钮 ， 然 后 将 会 展示 创建 新 账户 的 页 面 。 我 们 可 
以 通过 检查 WebDriver 的 title 属性 来 校 验 打 开 的 页 
面 是 否 符 合 预 期 结果 ， 代 人 码 如 下 。 





一 


# click on Create Account button. This will display 
# new account 


create_account_button.click() 


# check title 
self .assertEquals("Create New Customer Account - 
Magento Commerce Demo Store", driver.title) 





在 创建 新 账户 页 面 ， 可 以 通过 调用 
find_element_by_* 方法 来 查找 定位 所 有 的 元 素 。 





# get all the fields from Create an Account form 

first name = driver.find element by id("firstname") 

last name = driver.find element by id("lastname") 

email address - driver.find element by id("email addres 

s" 

news letter subscription - 
driver.find element by id("is subscribed") 


password - driver.find element by id("password") 
confirm password = driver.find element by id("confirmat 
ion" 


submit button - 
driver.find element by xpath("//button[Q)title-'Submit 
FIR) 





4.4.2 ”获取 元 系 对 应 有 的 值 


get_attribute() 方 法 可 以 用 来 获取 元 素 的 属性 
值 。 例 如 ， 单 个 测试 是 用 来 验证 输入 姓 和 名 字 的 文 
本 框 的 最 大 字符 限制 是 255， 字 符 限 制 就 是 通过 
maxlength 属 性 来 实现 的 ， 如 下 代码 所 示 设 置 值 为 
2590 


<input type="text" id="firstname" name="firstname" valu 
e=" "n 


title-"First Name" maxlength="255" class="input-text 
required-entry"» 








我 们 可 以 通过 调用 get_attribute() 方 法 来 校 验 
maxlength 属性 是 个 正确 。 





(1) 需要 把 属性 名 称 作 为 参数 传递 给 
get attribute() 77 7; . 
# check maxlength of first name and last name textbox 


self.assertEqual("255", first name.get attribute("maxle 
ngth")) 


self.assertEqual("255", last name.get attribute("maxlen 
gth")) 








(20 添加 以 下 代码 到 测试 脚本 中 ， 以 确保 所 
有 的 字段 对 于 用 户 都 是 可 见 和 可 用 的 。 





# check all fields are enabled 
self.assertTrue(first name.is enabled()and last 
name.is enabled() 
and email address.is enabled() and news lette 


r subscription.is enabled() 

and password.is enabled() and confirm passwor 
d.is enabled() 

and submit button.is enabled()) 





4.4.3 is selected()7; i7: 

is selected() 方法 是 针对 单 选 按钮 和 复 选 杠 
的 。 我 们 可 以 通过 调用 该 方法 来 得 知 一 个 单 选 按钮 
或 复 选 框 是 否 被 选中 。 





单 选 按钮 或 复 选 框 可 以 通过 WebElement 的 
click) 方法 来 执行 点 击 操作 ， 从 而 选中 该 元 素 。 如 
下 面 的 例子 ， 检 查 Sign UP for Newsletter 复 选 杠 是 
售 默 认为 不 被 选 中 的 ， 示 例 代 码 如 下 。 


# check Sign Up for Newsletter is unchecked 


self.assertFalse(news_letter_subscription.is sel 
ected()) 


4.4.4 clear()Ssend_keys() 777% 


clear() 和 send_keys() 方 法 适用 于 文本 框 和 文本 
域 ， 分别 用 于 清除 元 系 的 文本 内 容 和 模拟 用 户 操 作 
键 往来 输入 文本 信息 。 待 输入 的 文本 作为 
send_keys() 方法 的 参数 。 











C1) 添加 下 面 的 代码 ， 通 过 send_keys0) 方法 
来 给 对 应 的 字段 填写 值 。 





# fill out all the fields 

first name.send keys("Test") 
last name.send keys("User1") 
news letter subscription.click() 


email address.send keys("TestUser 150214 2200@example.c 
om") 

password.send keys("tester") 

confirm password.send keys("tester") 








(2) 最 终 通过 校 验 欢迎 信息 来 检查 用 户 是 否 
创建 成 功 。 











我 们 可 以 通过 text 属性 来 获取 元 素 的 文本 内 


LAS 


o 


# check new user is registered 
self.assertEqual("Hello, Test User1!", driver.find 


element by css selector("p.hello » strong").text) 
self.assertTrue(driver.find element by link text("LogOu 
t").is displayed()) 





(3) 下 面 是 创建 一 个 账户 功能 的 完整 测试 。 


运行 这 个 测试 脚本 将 看 到 在 Create An Account 页 面 
的 所 有 操作 。 





from selenium import webdriver 
from time import gmtime, strftime 
import unittest 


class RegisterNewUser(unittest.TestCase): 
def setUp(self): 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 


/") 


def test register new user(self): 
driver - self.driver 


# click on Log In link to open Login page 
driver.find element by link text("ACCOUNT").clic 
k() 


lick() 


driver.find element by link text("My Account").c 


# get the Create Account button 
create_account_button = \ 


driver.find element by link text("CREATE AN 
ACCOUNT" ) 


# check Create Account button is displayed 
# and enabled 
self.assertTrue(create_account_button. 

is displayed() and 

create account button.is enabled()) 


# click on Create Account button. This will 
# display new account 
create account button.click() 


# check title 


self.assertEquals("Create New Customer Account", 
driver.title) 


# get all the fields from Create an Account form 

first name = driver.find element by id("firstnam 
e") 

last name = driver.find element by id("lastname" 
) 

email address - driver.find element by id("email 
address") 

password = driver.find element by id("password") 

confirm password - driver.find element by id("co 
nfirmation") 


news letter subscription = driver.find element b 
y id("is subscribed") 

submit button = driver.\find element by xpath (" 
/ /button[Qgtitle-'Register']") 


# check maxlength of first name and 

# last name textbox 

self .assertEqual("255", first name.get attribute 
("maxlength")) 

self.assertEqual("255", last name.get attribute( 
"maxlength")) 


# check all fields are enabled 
self.assertTrue(first name.is enabled() 

and last name.is enabled() 

and email address.is enabled() and 

news letter subscription.is enabled() and 

password.is enabled() and 

confirm password.is enabled() 

and submit button.is enabled()) 


# check Sign Up for Newsletter is unchecked 
self.assertFalse(news letter subscription. is se 
lected()) 


user name = "user " + strftime ("%Y%m%d%H~M%S" , 
gmtime()) 


# fill out all the fields 

first name.send keys("Test") 

last name.send keys(user name) 

news letter subscription.click() 

email address.send keys(user name + "@example.co 
m") 

password.send keys("tester") 


confirm password.send keys("tester") 


# click Submit button to submit the form 
submit button.click() 


# check new user is registered 
self.assertEqual("Hello, Test " + user name + "! 


driver.find element by css selector("p.hello 


»strong").text) 
driver.find element by link text("ACCOUNT").clic 


k() 
self.assertTrue(driver.find element by link text 
("Log Out").is displayed()) 


def tearDown(self): 
self.driver.quit() 


if name == " main ": 
unittest.main(verbosity-2) 





45 Pete Bie f 


Selenium WebDriver 提 供 了 特定 的 Select 类 实现 
Ey EB BARRAS. WW IB 
MFF, nPIEMERSU—APJAESESTEBBERDS 


单 。 


M Magento” This is a demo store. Any orders pla 


Meese cues English v 


English 





| French 





German 


ISLAND 


下 拉 某 单 和 列表 是 通过 HTMEL 的 <select> 元 素 
实现 的 。 选 择 项 是 通过 <select> 中 的 <option> 元 素 实 
现 的 ， 如 下 HTML 代 码 。 





<select id="select-language" title="Your Language" 
onchange="window. location. href=this.value"> 
<option value="http://demo.magentocommerce.com/? 
|  Store-default&amp; _ from store-zdefault" 


selected-"selected"»English«/option» 
«option value="http://demo.magentocommerce.com/? 


||  store-french&amp; from storezdefault"»French«/ 
option» 





«option value="http://demo.magentocommerce.com/? 
_ Store-german&amp; _ from store-default"»German«/ 
option» 
</select> 








每 个 <option> 元 素 都 有 属性 值 和 文本 内 容 ， 是 
用 户 可 见 的 。 例 如 ， 在 下 面 的 代码 中 ，<option> 设 
置 的 是 店铺 的 URL， 后 面 参 数 设 置 的 是 语言 种 类 ， 


这 里 是 French。 





<option value="http://demo.magentocommerce.com/customer 


/ 


account/create/? store-french&amp; 
___ from store-zdefault"»French«/option» 





4.5.1 Select 原理 

Select 类 是 Selenium 的 一 个 特定 的 类 ， 用 于 与 
下 拉 亲 单 和 列表 交互 。 它 提供 了 丰富 的 功能 和 方法 
KEMAH Ee 








下 面 两 小 市 的 表格 列 出 来 Select 类 中 所 有 的 功 
能 和 方法 。 你 也 可 以 在 下 面 网 址 获取 类 似 信息 。 


http://selenium.googlecode.com/git/docs/api/py/we 


selenium.webdriver.support.select 


4.5.2 Select 功能 


Select 类 实现 的 功能 见 下 表 。 





功能 /属性 


, 获取 下 拉 菜 单 和 列表 中 被 选中 的 所 , 
all_selected_options 有 " select element.all selected options 
有 选项 内 容 








获取 下 拉 菜 单 和 列表 的 所 有 选项 “| select_element.options 








| 获取 下 拉 菜 单 和 列表 的 第 一 个 选项 
first_selected_option wen select_element.first_selected_option 
/ 当前 选择 项 


4.5.3 Select7; 17: 


Select 类 实现 的 方法 见 下 表 。 


deselect_all() 


deselect_by_index(index) 


deselect_by_value(value) 


deselect_ 


by_visible_text(text) 


清除 多 
选 下 拉 
菜单 和 
列表 的 
所 有 选 
择 项 

















根据 索 
引 清除 
PA 
单 和 列 
表 的 选 
择 项 





清除 所 























清除 所 
有 展示 
的 文本 
和 给 定 
参数 匹 
配 的 下 


hoo 








ET 实 fil 


select_element.deselect_all() 


index: 

要 清除 

的 目标 |select element.deselect by index(1) 
选择 项 

的 索引 





























select_element.deselect_by_value("foo") 











text: 要 


清除 的 
目标 选 | select_element.deselect_by_visible_text("bar") 
择 项 的 








和 列表 | 文本 值 








select_by_index(index) 、 ^ | select_element.select_by_index(1) 





























select_by_value(value) B select element.select by value("foo") 








和 给 定 
select_by_visible_text(text) | _ select element.select by visible text("bar") 
配 的 下 
拉 菜单 
和 列表 
的 选择 
项 

















让 我 们 进一步 探 所 这 些 功 能 和 方法 ， 我 们 回 到 
刚才 被 测 网 站 的 语言 选择 功能 。 我 们 将 为 前 面 草 市 
创建 好 的 主页 面 的 测试 类 添加 一 个 新 的 测试 用 例 。 
这 个 测试 用 例 用 来 验证 是 人 否 有 8 种 语言 可 供用 户 选 
择 。 我 们 将 首先 使 用 options 属性 来 验证 选项 的 个 数 
是 合 和 预期 结果 一 人 怪 ， 然 后 通过 获取 每 个 选项 的 文 
本 来 与 预期 的 选项 列表 相 比 较 ， 从 而 校 验 是 否 一 
BL, fu BATA 








def test language options(self): 
# list of expected values in Language dropdown 
exp options - ["ENGLISH", "FRENCH", "GERMAN"] 


# empty list for capturing actual options displayed 
# in the dropdown 
act options - [] 


# get the Your language dropdown as instance of Sel 
ect class 
select language = \ 
Select(self.driver.find element by id("select-la 


nguage")) 


# check number of options in dropdown 
self.assertEqual(2, len(select language.options)) 


# get options in a list 


for option in select_language.options: 
act_options.append(option.text) 


# check expected options list with actual options 1 
ist 
self .assertListEqual(exp options, act options) 


# check default selected option is English 
self.assertEqual("ENGLISH", select language.first s 
elected option. text) 


# select an option using select by visible text 
select language.select by visible text("German") 


# check store is now German 
self.assertTrue("store-german" in self.driver.curre 
nt url) 


# changing language will refresh the page, 
# we need to get find language dropdown once again 
select language = \ 
Select(self.driver.find element by id("select-lan 
guage")) 
select language.select by index(0) 





options 属 性 返回 一 个 下 拉 选 项 和 列表 里 的 所 有 
«option» 元 素 。 选 项 列表 里 的 每 个 选项 都 是 一 个 
WebElement 类 的 实例 。 





我 们 也 可 以 通过 用 first_selected_option 属 性 来 


校 验 默 认 / 当 前 选择 项 是 否 正确 。 





all selected options 属性 是 用 来 测试 多 选 
的 下 拉 选 项 和 列表 的 。 








最 后 ， 我 们 用 下 面 的 代码 来 实现 : 选择 一 个 语 
言 选项 ， 然 后 校 验 保存 的 URE 是 人 否 能 够 随 关 语言 选 
项 的 改变 而 正确 地 变化 。 


# select an option using select by visible text 
select language.select by visible text("German") 


# check store is now German 


self.assertTrue("store-german" in self.driver.current u 
r1) 





一 个 或 多 个 选项 可 以 基于 索引 来 选择 (该 选项 
在 列表 中 的 位 置 ) ， 也 可 以 根据 属性 值 或 者 文本 值 
来 选择 。select 类 提供 了 很 多 select_ 方法 来 选择 选 


项 。 在 上 面 这 个 例子 中 ， 我 们 使 用 
select by visible text() 方法 来 选择 选项 。 反 之 ， 我 
们 也 可 以 用 各 种 deselect_ 方法 来 取消 选择 。 





4.6 操作 警告 和 弹出 杠 


开发 人 员 使 用 JavaScript 警告 或 者 模 态 对 话 框 
来 提示 校 验 错 误 信 息 、 报 警 信 息 、 执 行 操 作 后 的 返 
回信 息 ， 甚 至 用 来 接收 输入 值 等 。 本 节 我 们 将 了 解 
如 何 使 用 Selenium 来 操控 警告 和 弹出 框 。 











4.6.1 Alert 原理 


Selenium WebDriver 通过 Alert 类 来 操控 
JavaScript 警告 。Alert 包含 的 方法 有 接受 、 驶 回 、 
输入 和 获取 警告 的 文本 。 





4.6.2 Alert 功能 


Alert 实现 了 下 表 的 功能 









































- pm ii 


4.6.3  Alert7; 1X 


Alert 实 现 了 下 表 的 方法 。 


接受 JavaScript fei, È 
accept() alert.accept() 
击 OK 按钮 





























驶 回 JavaScript 警告 信息 ， 单 
D ME sides 
(Iz 
send_ a value: 待 输入 目 
keii 模拟 给 元 素 输入 信息 段 的 字符 中 alert.send_keys("foo") 
eys(*value 符 串 


在 样 例 程序 中 ， 可 以 看 到 使 用 Alert 通知 或 告 
警 。 用 户 先 添加 产品 进行 比较 ， 然 后 移 除 一 个 或 多 
个 产品 时 ， 被 测 程序 将 会 显示 一 个 如 下 图 这 样 的 告 


A zi ed JU o 


























=! Apps [7] Selenium (73 Agile (7 Syt x pts «.. 
| The page at demo.magentocommerce.com says: 
Meu asi English Y 


Are you sure you would like to remove all products from 


M ^ D | SC your comparison? ACCOUNT 


OK Cancel 








ISLANL — Lani 
WOMEN MEN ACCESSORIES HOME & DECOR SALE VIP 
HOME / SEARCH RESULTS FOR: PHONES 
SHOP BY 1 The product Madison Earbuds has been added to comparison 
CATEGORY : : 
SEARCH RESULTS FOR PHONES 
Home & Decor (3) 
SORT BY: [Relevance v| 4 
COMPARE PRODUCTS (1 3 Item(s) 


MADISON EARBUDS x 


我 们 将 设计 一 个 测试 来 验证 单 击 COMPARE 
PRODUCTS (产品 比较 ) 功能 中 的 Clear Al 链接 
时 ， 是 否 会 弹出 警告 提醒 用 户 。 





创建 一 个 新 的 测试 类 CompareProducts， 并 添加 
测试 场景 的 代码 ， 搜 索 并 添加 一 个 产品 到 比较 列表 
中 ， 代 码 如 下 。 





from selenium import webdriver 
import unittest 


class CompareProducts(unittest.TestCase): 
def setUp(self): 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 
self.driver.get("http://demo.magentocommerce.com 


test compare products removal alert(self): 


# get the search textbox 
search field = self.driver.find element by name( 


search field.clear() 

# enter search keyword and submit 
search field.send keys("phones") 
search field.submit() 

# click the Add to compare link 
self.driver.\ 


find element by link text("Add to Compare"). 
click() 


当 单 击 Add to Compare 链接 将 一 个 产品 添加 到 
比较 列表 时 ， 将 会 看 到 一 个 产品 添加 到 COMPARE 
PRODUCTS 下 面 。 这 个 时 候 还 可 以 添加 其 他 的 产 
品 到 比较 列表 。 如 果 想 从 比较 列表 移 除 所 有 的 产 


品 ， 可 以 在 COMPARE PRODUCTS 模块 单 击 Clear 
All 链接。 这 个 时 候 可 以 看 到 一 个 警告 提示 “是 售 确 
认 移 除 所 有 的 产品 ”。 我 们 可 以 通过 Alert 来 操控 这 
个 警告 。 调 用 WebDirver 的 Switch_to_alert( 方法 可 
以 返回 一 个 Alert 的 实例 。 我 们 可 以 利用 这 个 Alert 
实例 来 获取 警告 信息 ， 并 通过 单 击 OK 按 钮 来 接受 

个 警告 信息 ， 或 者 通过 单 击 Cancel 按钮 来 拒绝 这 
个 警告 。 添 加 下 面 的 代码 到 测试 脚本 中 ， 这 部 分 代 
码 用 来 读 取 并 且 校 验 警 告 信 息 是 人 否 正 确 ， 然 后 通过 
调用 accept0 方法 来 接受 警告 。 


























# click on Remove this item link, this will display 
# an alert to the user 


self.driver.find element by link text("Clear All"). 
click() 


# switch to the alert 
alert - self.driver.switch to alert() 


# get the text from alert 
alert text = alert.text 


# check alert text 
self.assertEqual("Are you sure you would like to 
remove all products from your comparison?", alert 


text) 


# click on Ok button 
alert.accept() 


def tearDown(self): 
self.driver.quit() 


if name == " main _ 


unittest.main() 





4.6.4 iX iE S bee 


通过 单 击 浏览 器 工具 栏 上 的 后 退 、 前 进 、 刷 新 
/ 重新 加 载 按钮 ， 可 以 实现 访问 历史 页 面 、 刷 新 当 
前 页 面 等 操作 。Selenium WebDriver API 提供 了 很 
多 操控 这 些 按钮 的 方法 ， 我 们 可 以 使 用 这 些 方法 来 
验证 浏览 器 的 行为 。WebDriver 类 提供 了 以 下 方法 
来 操控 浏览 右 的 后 退 、 前 进 和 刷新 等 操作 。 


H driver.back() 












































H 后 退 到 浏览 器 当前 会 话 的 历史 记录 中 的 前 一 步 操作 


一 步 操 




















向 前 一 步 到 浏览 器 当前 会 话 的 历史 记录 中 的 后 


forward() | 作 JE driver.forward() 








refresh() 新 浏览 器 中 的 当前 页 面 driver.refresh() 


BEL EY Bl Fe a DV i APERTE D] as E 
记录 并 验证 程序 的 状态 。 








import unittest 

from selenium import webdriver 

from selenium.webdriver.support.ui import WebDriverWait 
from selenium.webdriver.support import expected_conditi 
ons 


class NavigationTest(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver = webdriver.Chrome() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://www.google.com") 


def testBrowserNavigation(self): 
driver = self.driver 
# get the search textbox 
search field = driver.find element by name("q") 
search field.clear() 


# enter search keyword and submit 
search field.send keys("selenium webdriver") 


search_field.submit() 


se wd link = driver.find element by link text("Sel 
enium WebDriver") 

se wd link.click() 

self.assertEqual("Selenium WebDriver", driver.titl 


e) 


driver.back() 
self.assertTrue(WebDriverWait(self.driver, 10) 
.until(expected conditions.title is 
"selenium webdriver - Google Search"))) 


driver.forward() 
self.assertTrue(WebDriverWait(self.driver, 10) 
.until(expected conditions.title is 
("Selenium WebDriver"))) 


driver.refresh() 
self.assertTrue(WebDriverWait(self.driver, 10) 
.until(expected conditions.title is 
("Selenium WebDriver"))) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


if name == ' main ': 
unittest.main() 





42 章节 回顾 


本 章 介 绍 了 Selenium WebDriver API 与 页 面 各 
种 元 素 的 交互 实现 。Selenium WebDriver API 提供 
了 不 同 的 类 、 功 能 和 方法 来 模拟 用 户 的 动作 ， 从 而 
校 验 应 用 程序 的 状态 。 这 些 方 法 能 够 自动 化 操控 的 
元 素 有 文本 框 、 按 钮 、 复 选 枉 和 下 拉 列 表 等 。 





同时 ， 我 们 还 设计 了 一 些 处 理 警 告 的 测试 ， 学 
习 了 操控 浏览 磺 的 方法 ， 并 且 测 试 了 浏览 右 在 不 同 
页 面 之 间 的 跳 转 。 


MOTA. SA MM 
加 稳定 的 测试 。 


步 学 习 Selenium API 如 
能 够 帮助 我 们 构建 更 





"Boii ”元 系 等 得 机制 


能 全 构建 健壮 和 可 徘 的 测试 是 UI 目 动 化 测试 能 
个 成 功 的 关键 因素 之 一 。 然 而 当 一 个 测试 接着 一 个 
测试 执行 的 时 候 ， 管 第 会 遇 到 各 种 不 同 的 状况 。 妆 
使 用 脚本 定位 元 又 或 去 验证 程序 的 运行 状态 时 ， 有 
时 候 会 及 现 找 不 到 元 素 ， 这 可 能 是 由 于 突然 的 资源 
受 限 或 网 络 延迟 引起 的 啊 应 速度 太 慢 所 导致 ， 这 时 
测试 报告 束 会 返回 测试 失败 的 结果 。 我 们 需要 在 测 
试 脚本 中 引入 延 时 机 制 ， 来 使 脚本 的 运行 速度 与 程 
序 的 啊 应 速度 相 匹 配 。 换 句 话 说 ， 我 们 需要 使 脚本 
和 程序 的 响应 能 够 同步 。WebDriver 为 这 种 同步 提 
供 了 隐 式 等 竺 和 显 陈 等 待 两 种 机 制 。 









































本 草包 含 以 下 主题 : 





。 Afi] [EF BS SERE B SERE? 


。 ATA TUE PEH Bek USS 459 E RASEN? 
。 使 用 预期 等 竺 条件 ; 
。 创建 日 定 义 的 等 竺 条 件 。 


5.1 KNE 


隐 式 等 竺 为 WebDriver 中 的 完整 的 一 个 测试 用 
例 或 者 一 组 测试 鸭 同步 ， 提 供 了 通用 的 方法 。 隐 式 
等 待 对 于 解决 由 于 网 络 延迟 或 利用 Ajax 动态 加 载 元 
系 所 导致 的 程序 啊 应 时 间 不 一 致 ， 是 非常 有 效 的 。 








当 设 置 了 隐 式 等 竺 时 间 后 ，WebDriver 会 在 一 
定 的 时 间 内 持续 检测 和 搜寻 DOM， 以 便于 得 找 一 
个 或 多 个 不 是 立即 加 载 成 功 并 可 用 的 元 素 。 一 般 情 
况 下 ， 隐 陈 等 竺 的 默认 超时 时 间 设 置 为 0。 











一 旦 设置 ， 隐 式 等 待 时 间 就 会 作用 于 这 个 
WebDriver 实 例 的 整个 生命 周期 或 者 一 次 完整 测试 
的 执行 期 间 ， 并 且 WebDriver 会 使 其 对 所 有 测试 步 
又 中 包含 整个 页 面 的 元 素 的 查找 时 都 有 效 ， 除 非 把 
默认 超时 时 间 设 置 回 0。 








WebDriver 类 提供 了 implicitly_wait(0) 方 法 来 配 
置 超时 时 间 。 本 书 在 第 2 草 已 经 创建 了 
SearchProductTest 测 试 闪 ， 和 是 基于 unittest 写 的 训 
试 。 我 们 将 基于 这 个 类 进行 修改 ， 在 setUp0 方法 中 
加 入 隐 式 等 得 时 间 并 且 设 置 为 10 秒 ， 代 码 如 下 面 的 
例子 所 示 。 当 一 个 测试 用 例 执行 的 时 候 ， 
WebDirver 在 找 不 到 一 个 元 北 的 时 候 ， 将 会 等 待 10 
秒 。 当 达到 10 秒 超时 时 间 后 ， 将 会 抛 出 一 个 


NoSuchElementException [f$ o 











import unittest 
from selenium import webdriver 


class SearchProductTest(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver - webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 


/") 


def test_search_by_category(self): 
# get the search textbox 


self.search field = self.driver.find_element_by_ 
name("q") 
self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys("phones") 
self.search field.submit() 


# get all the anchor elements which have product 
names 
# displayed currently on result page using 
it find elements by xpath method 
products = self.driver\ 
.find elements by xpath 
("//h2[class-'product-name']/a") 


# check count of products shown in results 
self.assertEqual(2, len(products)) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


if name == ' main ': 
unittest.main(verbosity-2) 

















应 尽量 避免 在 测试 中 隐 式 等 待 与 显 式 等 
合 使 用 ， 来 处 理 同 步 问 题 。 相 比 隐 式 等 


A. SN 
EEG ri 
Ed 


寺 ， 显 式 等 竺 能 提供 更 好 的 可 操控 性 。 

















显 式 等 待 是 WebDriver 中 用 于 同步 测试 的 另外 
一 种 等 待机 制 。 显 式 等 待 比 隐 式 等 待 具备 更 好 的 操 
控 性 。 与 隐 式 等 待 不 同 ， 我 们 可 以 为 脚本 设置 一 些 
预 置 或 定制 化 的 条 件 ， 等 待 条 件 满足 后 再 进行 下 一 


步 测 试 。 




















显 式 等 待 可 以 只 作用 于 仪 有 同步 需求 的 测试 用 
例 。WebDriver 提 供 了 WebDriverWait 类 和 


expected_conditions 类 来 实现 显 式 等 待 。 





expected_conditions 类 提供 了 一 些 预 置 条 件 ， 来 
作为 测试 脚本 进行 下 一 步 测试 的 判断 依据 。 让 我 们 
创建 一 个 包含 显 式 等 得 的 简单 的 测试 ， 条 件 是 等 竺 
一 个 元 系 可 见 ， 代 码 如 下 。 








from selenium import webdriver 
from selenium.webdriver.common.by import By 
from selenium.webdriver.support.ui import WebDriverWait 


from selenium.webdriver.support import expected_conditi 
ons 
import unittest 


class ExplicitWaitTests(unittest.TestCase): 
def setUp(self): 
self.driver = webdriver.Firefox() 
self .driver.get("http://demo.magentocommerce.com 


/") 


def test account link(self): 
WebDriverWait(self.driver, 10)\ 
.until(lambda s: s.find element by id("selec 


t- 
language").get attribute("length") -- "3") 
account = WebDriverWait(self.driver, 10)\ 
.until(expected conditions. 
visibility of element located 
((By.LINK TEXT, "ACCOUNT"))) 
account.click() 
def tearDown(self): 
self.driver.quit() 
if name == " main ": 


unittest.main(verbosity-2) 








在 上 面 的 测试 中 ， 显 式 等 竺 条 件 是 等 到 Log In 
链接 在 DOM 中 可 见 。 


使 用 visibility_of element. located77 YA R 24] Br Pii 


期 条 件 是 个 满 足 。 该 条件 判断 方法 需要 设置 符合 要 
求 的 定位 集 略 和 位 置 详细 信息 。 脚 本 将 一 直 俘 找 目 
标 元 素 是 耕 可 见 ， 下 到 达到 最 大 等 每 时 间 10 秒 。 一 
FURS Ta EE AL ae KB SCR HURT AE 
法 将 会 把 定位 到 的 元 系 返 回 给 测试 脚本 。 

















如 果 在 设 定 的 超时 时 间 内 ， 仍 然 没 有 通过 定位 
髓 找到 可 见 的 目标 元 系 ， 将 会 抛 出 


TimeoutException 异 党 。 





5.3 expected conditions 





下 表 是 expected_conditions 类 支持 的 在 执行 网 页 
浏览 右 自 动 化 操作 时 第 音 用 到 的 一 些 通 用 的 等 竺 条 
件 Oo 











预期 条 件 












































locator: 





WebDriverWait(self.driver, 


10).until(expected_conditions.e. 


element_to_be_clickable(locator) d 一 组 








(by, locator ) 














定位 到 的 元 
素 




















等 待 直到 指 | element: subscription = self.driver.find_e 
element_to_be_selected(element) 定 的 元 素 被 | 是 个 WebDriverWait(self.driver, 10) 


选中 WebElement | element_to_be_selected(subscri 





A 4. 


等 待 一 个 元 

素 在 DOM WebDriverWait(self.driver, 10) 

中 不 可 见 或 invisibility_of_element_located 
(by, locator ) 

不 存在 


invisibility_of_element_located(locator) 











等 待 直到 至 
少 有 一 个 定 
位 器 查找 匹 


配 到 的 目标 
元 素 出 现在 locator: WebDriverWait(self.driver, 10) 




















presence_of_all_elements_located(locator) 网 页 中 车 组 until(expected_conditions.prese 
(by,locator) | NAME,"input-text"))) 





该 方法 返回 
定位 到 的 一 
组 

WebElement 





等 待 直到 定 
位 器 查找 匹 
配 到 的 目标 
元 素 出 现在 
网 页 中 或 可 WebDriverWait(self.driver, 10) 























presence_of_element_located(locator) 


以 在 DOM until(expected_conditions.prese 
(by, locator ) 


中 找到 。 
该 方法 返回 








locator: 
至 组 WebDriverWait(self.driver,10). 


text_to_be_present_in_element(locator,text_) j J (by,locator) |until(expected conditions.text 1 


























text: i; £M language"),"English")) 





验 的 文本 内 容 
等 待 网 页 标 
题 包含 指定 
的 大 小 写 敏 
感 的 字符 | title: 被 校 验 m | 
. "P sy ug; | WebDriverWait(self.driver, 10) 
title contains(title) EB 的 包含 在 标题 





NewCustomer Account")) 


该 方法 在 匹 | 中 的 字符 串 
配 成 功 时 返 











title_is(title) 


visibility_of(element) 


visibility_of_element_located(locator) 


True, 7 


则 返回 False 











该 方法 在 匹 
配 成 功 时 返 
加 True， 否 


False 












































并 且 宽 和 高 
都 大 于 0。 

cH. 
可 见 的 ， 记 
方法 将 返 
《同一 个 ) 

WebElement 


















































等 待 直到 根 
据 定位 器 查 
找 的 目标 元 
素 出 现在 

DOMH!, 

是 可 见 的 ， 
并 且 宽 和 高 
都 大 于 0。 

一 旦 其 变 成 
可 见 的 ， 该 
方法 将 返回 



































title: 网 页 的 标 | WebDriverWait(self.driver, 10) 


element : 
目标 
WebElement 


locator: 
组 
(by,locator) 


CustomerAccount -MagentoCol 


first_name = self.driver.find_ele 


10). until(expected conditions. 


WebDriverWait(self.driver, 10) 


until(expected conditions.visibi 


WebElement | 


在 下 面 的 网 址 可 看 到 预期 条 件 判断 的 完整 列 
表 : 
http://selenium.googlecode.com/git/docs/api/py/webdrh 
support.expected conditions.html£module-selenium. 


webdriver.support. expected conditions. 





在 下 面 的 章节 中 ， 让 我 们 通过 几 个 例子 来 了 解 
更 多 的 预期 条 件 判 断 。 


5.3.1 FART IU 7e BFE 


正如 在 前 面 章节 看 到 的 ，expected_conditons 类 
提供 了 各 种 各 样 的 预期 等 得 条件， 我 们 可 以 在 脚本 
中 实现 。 在 下 面 的 例子 里 ， 我 们 将 等 竺 一 个 元 系 变 
成 可 用 或 可 点 击 。 我 们 可 以 在 Ajax 应 用 较 多 的 程序 
中 使 用 这 个 预期 等 待 条件， 这 样 表单 中 一 个 字段 是 
售 可 用 取 雇 于 表单 中 别 的 字段 或 过 沽 器。 该 例子 








中 ， 我 们 单 击 Log In 链 接 ， 然 后 等 得 Create an 
Account 按 钮 变 成 可 点 击 的 ， 这 些 元 系 都 在 登录 页 
面 。 最 后 我 们 单 击 Create an Account 按 钮 ， 等 待 下 
一 个 页 面 加 载 完 成 并 显示 出 来 。 





def test create new customer(self): 
# click on Log In link to open Login page 
self.driver.find element by link text("ACCOUNT").cl1 
ick() 


# wait for My Account link in Menu 
my account = WebDriverWait(self.driver, 10)^ 
.until(expected conditions.visibility of element 
. located((By. 
LINK TEXT, "My Account"))) 
my account.click() 


# get the Create Account button 
create account button - WebDriverWait(self.driver, 
10)^ 


.until(expected conditions.element to be clickab 
le((By.LINK 
TEXT, "CREATE AN ACCOUNT"))) 


# click on Create Account button. This will display 
ed new account 
create account button.click() 
WebDriverWait(self.driver, 10)\ 
.until(expected conditions.title contains("Creat 
e New Customer Account")) 








Bal Seta FP “Poa eT FA, A DA 
element to_be_clickable 预 期 条 件 。 议 方法 需要 指定 
定位 策略 或 具体 定位 的 位 置 。 当 目标 元 素 变 成 可 点 
击 或 者 可 用 的 时 候 ， 该 方法 返回 定位 到 的 目标 元 素 
给 测试 脚本 。 

















前 面 的 测试 也 介绍 了 通过 检测 标题 是 否 含 有 指 
定 的 文本 内 容 ， 来 确定 创建 新 用 户 页 面 是 人 否 加 载 成 
功 。 我 们 使 用 title_contains 预 期 条 件 来 检测 ， 以 确 
保 指 定 的 字符 串 能 够 与 预期 网 页 标题 的 子 字符 串 相 
UU fac . 








5.3.2 ”判断 是 否 存 在 Alerts 








我 们 也 可 以 将 显 式 每 每 应 用 于 管 告 和 页 面 框 染 
中 。 例 如 ， 一 个 复杂 的 JavaScript 处 理 过 程 或 后 端 处 
理 过 程 需要 花 缆 较 多 的 时 间 把 警告 反馈 给 用 户 ， 这 
时 可 以 用 alert_is_present 这 个 预期 判断 条 件 来 实 
现 ， 代 码 如 下 。 





from selenium import webdriver 

from selenium.webdriver.support.ui import WebDriverWait 
from selenium.webdriver.common.by import By 

from selenium.webdriver.support import expected_conditi 
ons 

import unittest 


class CompareProducts(unittest.TestCase): 
def setUp(self): 
self.driver = webdriver.Firefox() 
self .driver.get("http://demo.magentocommerce.com 


/") 


def test compare products removal alert(self): 
# get the search textbox 
search field = self.driver.find_element_by_name( 
"q") 
search field.clear() 


# enter search keyword and submit 
search field.send keys("phones") 
search field.submit() 


# click the Add to compare link 
self.driver.\ 
find element by link text("Add to Compare"). 
click() 


# wait for Clear All link to be visible 
clear all link = WebDriverWait(self.driver, 10)\ 
.until(expected conditions.visibility of ele 
ment 
located((By.LINK TEXT, "Clear A11"))) 


# click on Clear All link, 


# this will display an alert to the user 
clear all link.click() 


# wait for the alert to present 
alert = WebDriverWait(self.driver, 10)\ 
.until(expected conditions.alert is present( 


)) 


# get the text from alert 
alert text = alert.text 


# check alert text 
self.assertEqual("Are you sure you would like 
to remove all products from your comparison?", alert 
text) 
# click on Ok button 
alert.accept() 


def tearDown(self): 
self.driver.quit() 


if name == " main ^": 
unittest.main(verbosity-2) 








上 述 的 测试 脚本 ， 是 验证 从 产品 比较 列表 中 移 
除 所 有 的 产品 这 个 功能 。 妆 用 户 移 除 一 个 产品 的 时 
候 ， 会 收 到 是 否 确认 的 警告 。Alert_is_present 预期 
判定 条 件 束 可 以 用 来 检测 警告 窗口 是 否 出 现 ， 并 且 
把 警告 窗口 返回 给 脚本 ， 以 进行 后 续 的 动作 。 该 脚 





本 将 会 等 待 10 秒 的 时 间 来 检测 警告 窗口 是 耕 出 现 ， 
如 果 没 有 出 现 就 殷 出 异常 。 


5.4 预期 条 件 判断 的 实战 


正如 在 前 面 章 节 所 了 解 到 的 ， 
expected_conditions 类 提供 了 多 种 定义 好 的 预期 等 
等 条 件 。 我 们 也 可 以 通过 WebDriverWait 2€ E] xe X. 
预期 等 竺 条件。 当 没 有 合适 的 预期 等 待 条 件 可 用 的 
时 候 ， 自 定义 的 预期 等 竺 条件 也 是 非常 有 效 的 。 





让 我 们 来 修改 一 个 前 面 章节 中 创建 好 的 测试 脚 
本 ， 实 现 一 个 目 定 义 的 预期 条 件 判 断 ， 来 检测 下 拉 
列表 中 可 选项 的 数量 。 





def testLoginLink(self): 
WebDriverWait(self.driver, 10).until 
(lambda s: s.find element by id 
("select-language").get attribute("length") == "3" 


login link = WebDriverWait 
(self.driver, 10).until(expected conditions. 
visibility of element located((By.LINK TEXT,"Log 


In"))) 
login link.click(); 





我 们 可 以 使 用 Python 的 lambda 表 达 式 ， 并 且 基 
于 WebDriverWait 来 实现 目 定 义 的 预期 条 件 判 断 。 
上 面 的 例子 中 ， 脚 本 将 会 等 每 10 秒 ， 直 到 Select 
Language 下 拉 列 表 中 有 8 个 可 选项 。 当 下 拉 列 表 是 
通过 Ajax 调用 来 实现 ， 并 且 脚 本 需要 等 竺 下 拉 列 表 
中 的 所 有 选项 都 是 可 选择 时 ， 该 预期 条 件 判 断 是 非 
第 有 用 的 。 





5.5 B= [E] EN 





在 本 章 中 ， 我 们 认识 到 元 素 等 待机 制 对 于 构建 
高 度 稳定 可 靠 的 测试 来 说 是 必 不 可 少 的。 我 们 学 习 
了 隐 式 等 每 ， 并 且 通 过 例子 了 解 到 了 如 何 应 用 隐 式 
等 待 作为 通用 的 等 待机 制 。 显 式 等 竺 可 以 提供 更 灵 
活 的 方式 来 同步 进行 测试 。expected_conditions 类 提 
供 了 多 种 内 置 的 预期 等 竺 判定 条 件 ， 我 们 在 例子 中 
也 实践 了 一 部 分 。 











WebDriverWait 类 提供 了 更 加 强大 的 自 定义 预 
期 等 竺 判定 功能 ， 超 出 了 expected_conditions。 我 
们 在 下 拉 列 表 的 例子 中 束 实 现 了 目 定义 的 预期 等 等 
判定 。 





在 下 面 的 章节 中 ， 将 会 讲述 如 何 通过 使 用 
RemoteWebDriver#ll Selenium Server 使 测试 脚本 在 远 
程 机 器 上 执行 ， 并 用 通过 Selenium Grid 实现 脚本 的 


FFT PUT, BEM SLES DU bias EL 2) H5 YA; 


POR PSP VS dU A 


Selenium x FF FH & fix] Và as RAE TE AA 3 TJ 
PS dd DU o REVERS EAS [e] 20] Và, dti ABR VE A 
统 的 组 合 场景 下 执行 测试 ， 来 验证 Web 程 序 的 路 浏 
iat AAS PE, Aut e HJ EE] RP 08 PREIS UL ak 
器 和 操作 系统 上 使 用 程序 时 不 会 遇 到 问题 。 
Selenium WebDriver 文 持 在 远程 机 器 上 执行 测试 ， 
并 且 能 够 把 测试 分 友 到 安装 有 不 同 浏览 颖 和 操作 系 
统 的 远程 机 占 或 者 云端 执行 。 到 目前 为 止 ， 我 们 已 
经 学 习 了 在 安装 各 种 浏览 器 驱动 的 本 地 计算 机 上 如 
何 创 建 和 执行 测试 ， 如 下 图 所 示 。 





Web Application Under Test 





本 章 将 学 习 如 何在 远程 机 器 上 执行 测试 ， 并 且 
学 习 如 何在 由 不 同 浏览 磺 和 操作 系统 组 合成 的 分 布 
AUR rn B FO Las E E EAT IPS UE V S dx 
种 执行 路 浏览 器 测试 的 实现 方式 将 会 节省 大 量 的 时 
HE 








本 章 包含 以 下 主题 


e Selenium Standalone Server 的 下 载 和 使 用 ; 
e 如何 使 用 Remote 类 来 实现 在 Selenium Standalone 
Server 上 执行 测试 ; 





e 7ESelenium Standalone Server 上 执行 测试 ; 

e 为 Selenium Standalone Server jt A, MAWA 
分 布 式 执行 创建 一 个 Grid; 

。 在 安装 有 多 浏览 贷 和 操作 系统 组 合 的 Grid 上 执行 
isk 

e iii Sauce Labs 和 BrowserStack 在 云端 执行 测 
试 。 





6.1 Selenium Standalone Server 


Selenium Standalone Server 是 使 Selenium 具 备 
在 远程 机 器 上 执行 测试 能 力 的 一 个 重要 组 件 。 我 们 
需要 通过 使 用 RemoteWebDriver 类 来 连接 到 
Selenium Standalone Server， 从 而 实现 在 远程 机 器 
上 执行 测试 。RemoteWebDriver 类 通过 特定 的 端口 
监听 Selenium 根 据 测 试 脚本 所 下 达 的 命令 。 根 据 
RemotewWebDriver 关 提供 的 配置 选项 ，Selenium 
Server 可 以 选择 局 动 的 浏览 器 类 型 并 且 发 送 命令 给 
A Aar EJLER A A bias, FPA AY LSE 
于 Appium 来 实现 对 移动 平台 的 文 持 。 下 面 是 
Selenium Server 在 配置 了 不 同类 型 浏览 器 的 远程 机 
人 锅 上 执行 测试 的 架构 图 。 
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Remote Machines Running Browser Instances/Drivers using Selenium Server 


6.1.1 下载 Selenium Standalone Server 


Selenium Standalone Server 是 以 JAR 包 的 形式 下 
4%, FY LA Mhttp://docs.seleniumhg.org/ download/T4 
面 的 Selenium Server 〈 原 来 的 Selenium RC Server) 
章节 找到 。 写 这 本 书 时 ，Selenium Server 可 下 载 版 
本 是 2.41.0。 你 可 以 轻松 地 将 Selenium Standalone 
Server 的 JAR 包 文件 复制 到 远程 机 右上 并 局 动 服 


务 。 





Selenium Standalone Server 是 用 Java 语 言 
开发 的 ， 目 我 独立 。 在 运行 的 时 候 ， 机 器 上 
需要 安装 JRE(Java Runtime Environment)。 在 
运行 Selenium Standalone Server 之 前 ， 要 确保 
远程 机 器 上 已 经 安装 了 JRE6 或 者 更 局 的 版 
AX 





6.1.2. JH z/Selenium Standalone Server 


Selenium Standalone Server 能 以 不 同 的 模式 或 
角色 局 动 ， 在 本 章 市 我 们 末 用 的 古 Standalone 模 式 
启动 。 可 以 通过 在 远程 机 器 上 保存 有 Selenium 
Standalone Server 的 JAR 包 文件 的 目录 下 启动 命令 
行 ， 使 用 以 下 命令 启动 Selenium Server， 这 是 在 
Windows 8 中 启动 Selenium Standalone Server 的 命 





A, 


java -jar selenium-server-standalone-2.41.0.jar 





Selenium Server 司 动 后 ， 默 认 监 听 端 口号 是 
4444) Chttp://<remote-machine-ip>:444) 。 在 局 动 服 
务 时 ， 可 以 通过 命令 行 更 改 疹 口 号 。 下 图 是 
Selenium Server 司 动 时 的 命令 行 输出 。 





ers\UNMESH\Downloads>java -jar selenium-server-standalone-2.41.0.jar 
2014 6:34:38 PM org.openga.grid.selenium.GridLauncher main 
nching a standalone server 
.801 INFO - Java: Sun Microsystems Inc. 20.45-b01 
[18:34:38.803 INFO Windows 8 6.2 amd64 
18:34:38.844 INFO v2.41.0, with Core v2.41.0. Built from revision 3192d8a 
118:34 .125 INFO RemoteWebDriver instances should connect to: http://127.0.0. 


.128 INFO Version Jetty/5.1.x 
.130 INFO Started HttpContext [/selenium-server /driver , /selenium-server 


32 INFO Started HttpContext [/selenium-server ,/selenium-server ] 
33 INFO Started HttpContext[/,/] 


.268 INFO - Started org.openga. jetty. jetty.servlet.ServletHandler@2993a6 


J 





.269 INFO started i py cid due 


.276 INFO Started SocketListener on 0.0.0.0:4444 
.277 INFO - Started org.openga. jetty. jetty. Server@S5dccce3c 




















v 
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Selenium Server 在 远程 机 器 上 是 以 HTTP Server 
形式 局 动 的 ， 我 们 可 以 通过 浏览 器 启动 和 查看 该 服 
务 。 在 浏览 器 上 输入 http://<remote-machine- 
ip>:4444/wd/hub/static/resource/ hub.html， 就 可 以 看 
到 如 下 图 所 示 的 服务 局 动 后 的 界面 。 


L5 Wahre Huk: >x 
e — O |9 197.168.1.1021414 














eale Session | l | 12clresh Sessions 














现在 我 们 已 启动 并 运行 Selenium Server， 可 以 
开始 创建 和 执行 测试 了 。 


6.2 7 £Selenium Standalone Server E #4 
行 测试 


要 在 Selenium Server 上 执行 测试 ， 我 们 需要 使 
用 RemoteWebDriver。 这 个 Selenium Python 中 的 
Remote 类 以 客户 端的 身份 与 Selenium Server 进 行 交 
互 ， 从 而 实现 在 远程 机 器 上 运行 测试 。 我 们 使 用 这 
个 类 来 指示 Selenium Server 做 出 相应 的 操作 ， 以 在 
远程 机 器 上 运行 测试 ， 以 及 在 指定 的 浏览 器 上 运行 


测试 命令 。 





除了 Remote 关 之 外 ， 我 们 需要 设置 
desired_capabilities， 即 对 浏览 器 和 操作 系统 的 配 
置 ， 以 及 为 了 在 Selenium Standalone Server 上 运行 
测试 时 要 进行 的 一 些 其 他 配置 。 在 此 示例 中 ， 我 们 
将 指定 运行 测试 的 平台 和 浏览 器 名 称 ， 
desired_capabilities 配 置 如 下 。 


desired caps = {} 
desired caps['platform'] = 'WINDOWS' 





desired caps['browserName'] = ‘firefox 


接 下 来 ， 将 创建 一 个 Remote 类 的 实例 并 传递 
desired_capabilities。 当 脚本 执行 时 ， 该 类 将 连接 并 
请 求 Selenium Server 启 动 Windows 平 台 上 的 Firefox 
3 a TAT WX e 


self.driver = webdriver.Remote('http://192.168.1.103:44 





44/wd/hub', desired_caps) 


下 面 我 们 用 Remote 类 代 蔡 Firefox driver 实 现 一 
个 之 前 创建 的 搜索 测试 。 





import unittest 
from selenium import webdriver 


class SearchProducts(unittest.TestCase): 
def setUp(self): 
desired caps = {} 
desired caps['platform'] = 'WINDOWS' 
desired caps['browserName'] = 'firefox' 


self.driver = \ 


webdriver.Remote('http://192.168.1.102:4444/ 
wd/hub', desired caps) 


self.driver.get( ‘http: //demo.magentocommerce.com 
/') 

self.driver.implicitly wait(30) 

self.driver.maximize window() 


def testSearchByCategory(self): 
# get the search textbox 
self.search_field = self.driver.find_element_by_ 
name('q') 
self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys('phones') 
self.search field.submit() 


# get all the anchor elements which have product 
names 
# displayed currently on result page using 
it find elements by xpath method 
products = self.driver\ 
.find_elements_by_xpath('//h2[@class=\' produ 
ct-name\']/a') 


# check count of products shown in results 
self .assertEqual(2, len(products) ) 


def tearDown(self): 
# close the browser window 
self .driver.quit() 


if name == ' main ': 
unittest.main() 





当 执 行 此 测试 时 ， 我 们 可 以 观察 Selenium 





Server 控 制 台 的 输出 。 它 可 以 实时 显示 测试 脚本 与 
Selenium Server 之 间 是 如 何 进 行 交 互 的 ， 以 及 已 执 
行 的 命令 和 返回 状态 。 下 图 是 测试 执行 时 控制 台 的 


El 40 0 


ini itii cm litt 


-了 i, 


| i ii 
37.701 INFO - Started org. 1 Jetty. 
2 INFO - Executing: [new session: aed Ciel [{ Te serName=firefox, 
indows}]] at URL: /session) 
:22:58.037 INFO - Creating a new session for Capabilities [{browserName=firefo 
platfr om=wi ndows } ] 
3:18.587 INFO - Done: /session 
718.618 INFO - Executing: [get: http://demo.magentocommerce.com/] at URL: 
b3 390- b844-497 i 86af- e954c103409d/ur 1) 
5 /f79b3590-b844-4976-86af- e954c103409d/ur | 
438 INFO - seen ite [implicitly wait: 30000] at URL: /session/f79b359 
84 76-86af-e954c103409d/timeouts/implicit wait) 
9:23: 488 INFO - Done: /session/f79b3590-b844-4976-86af-e954c103409d/timeouts 


497 INFO - Executing: [find element: By.name: q] at URL: /session/f79b3 
-497€-86af-e954c103 Adis iie me. 
6.662 INFO - Done: / f79b3590-b844-4976-86af-e954c103409d/element 
= :26. 672 INFO - Exec ear: O [[FirefoxDri firefox on XP (ec78520 
um 780c-410d-$381-3ecda02933 Yr > name: q]] at URL: /session/f79b3590-b844-4976 
|-RGaf- e954c103409d/element /0/c lear) 
19:23:26.740 INFO - Done: /session/ /f7 9b3590-b844-4976-86af-e954c103409d/element / 


3 INFO - Executing: [send k 0 [[FirefoxDriver: refox on XP (e 
8520f -410d-9381- 3ecda029334d) | name: ql, [p, h, o, n, revs at URL: 
ssion b3590-b844-4976-86af- e954 09d/ element, 

856. INFO. - Done: Jsession/ 9 











在 浏览 器 的 http:// <remote-machine- 
ip»:4444/wd/hub/static/resource/hub.html 74 [E] u] LJ 7z 
现 ， 一 个 新 的 会 话 已 创建 。 当 鼠标 停留 在 
Capabilities 链 接 上 时 ， 将 显示 用 于 该 测试 的 
Capabilities 详 细 信 息 ， 如 下 图 所 示 。 











[A WebDriver Hub 





e > C [5 197.168.1.107:4444/wd/hub/static/resource/hub-html 





Sessions 





| Create Session | | | Refresh Sessions | 








| Firefox 1 gfc1c6f.3605-4803.863f.c90826525cOf | Capabilities | | Take Screenshot | | 


| Delete Session | | | Load Script | 














"Ha" { 


"plutform": "xp", 


J orlipL Enabled": Lrue, 
"acceptSslcerts": true, 
"browserName": "firefox", 
"rotatable": false, 
"locationContextEnabled": true, 
"version": "27.0.1", 
"databaseEnabled": true, 
"cssOclectorsEnabled": true, 
"handlesAlerrs": true, 
"browserConnectionEnabled": true, 
"webStorageEnabled": true, 
"nativeEvents": true, 
"applicationCacheEnabled": true, 
"rakesScreenshot": true 





Cluse 





6.2.1 配置 下 支持 


Selenium Server 与 Firefox 绑 定 ， 默 认 文 持 
Firefox， 但 是 要 想 在 Internet Explorer (IE) 上 执行 
测试 ， 束 需要 在 启动 Selenium Server 时 指定 IE driver 
可 执行 文件 的 路 径 。 下 面 是 在 命令 行 中 通过 配置 
webdriver.ie.driver 选 项 来 指定 IE driver 可 执行 文件 路 


java -Dwebdriver.ie.driver="C:\SeDrivers\IEDriverServer 
.exe" -jar 





selenium-server-standalone-2.41.0.jar 


通过 指定 正 driver 跤 从 启动 Selenium Server 后 ， 
就 可 以 在 远程 机 器 的 下 浏览 器 上 执行 测试 了 。 


6.2.2 fc Chrome xz $$ 


与 IE driver 类 似 ， 要 想 在 Chrome 上 执行 测试 ， 
Qt i 22 4a xe Chrome driver 可 执行 文件 。 下 面 是 通过 
配置 webdriver.chrome.driver 选 项 指定 Chrome driver 
可 执行 文件 路 径 的 命令 。 


java -Dwebdriver.ie.driver="C:\SeDrivers\IEDriverServer 
.exe" -Dwebdriver. 


chrome.driver="C:\SeDrivers\chromedriver.exe" -jar sele 
nium-server-standalone-2.41.0.jar 





WERF, Selenium Server 已 同时 支持 在 远程 机 器 
的 Internet Explorer Chromel) wa z& E FRIT J| VA o 


6.3 Selenium Grid 





Selenium Grid 可 以 将 测试 分 布 在 奋 干 个 物理 或 
虚拟 机 器 上 ， 从 而 实现 分 布 方式 或 并 行 方式 执行 测 
试 。 这 样 可 以 有 效 减少 执行 测试 所 需 周 期 ， 同 时 实 
现 路 浏览 器 测试 来 获得 更 快 、 更 准确 的 结果 反馈 。 
我 们 可 以 使 用 云端 现 有 的 虚拟 机 建立 Grid。 














Selenium Grid 能 够 在 右 干 个 节点 或 客户 端 上 并 
行 执行 多 个 测试 ， 这 些 节 点 或 客户 端 都 可 以 是 不 同 
浏览 器 和 操作 系统 ， 从 而 文 持 混 合 的 测试 环境 。 
Grid 使 所 有 节点 如 下 图 展示 的 那样 ， 在 底层 独立 且 
透明 地 实现 分 布 测试 。 
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6.3.1 局 动 hub 





在 分 布 式 测试 中 ， 局 动 Selenium Server 作 为 一 
个 hub，hub 提 供 所 有 可 用 的 配置 或 属性 信息 给 要 执 
行 的 测试 ， 然 后 slave 机 器 (也 称 为 方 点 ) 将 连接 到 
这 个 hub。 测 试 脚 本 运用 JSON Wire Protocol， 并 通 
过 Remote 类 与 hub 交 互 来 执行 Selenium 命 令 。 更 多 
关于 JSON Wire Protocol 的 信息 可 以 访问 


https://code.google.com/p/selenium/wiki/JsonWireProtc 


hub 作 为 中 心 节 点 ， 接 收 测试 命令 并 将 它们 分 
发 给 适当 节点 或 符合 罗 配 要 求 的 节点 。 下 和 面 我 们 来 
将 Selenium Server 配 置 成 Grid， 然 后 配置 一 些 不 同 
浏览 器 和 操作 系统 组 合 的 节点 。 





用 前 面 章节 中 学 到 的 命令 并 添加 一 些 参数 ， 就 
可 以 将 Selenium Standalone Server 作 为 hub (也 称 为 
Grid Server) 司 动 。 首 先 打 开 一 个 新 的 命令 行 /终端 
窗口 ， 然 后 定位 到 Selenium Server JAR 所 在 的 位 
置 。 输 入 以 下 命令 以 hub 形 式 启 动 Server。 





注意 : 要 将 Server 配 置 成 hub 或 者 Grid Server, 
那么 在 司 动 时 就 需要 指定 -role 参 数 ， 值 为 "hub”。 
本 例 中 ， 我 们 是 在 Windows 系 统 中 启动 Server。 下 
图 是 启动 过 程 中 控制 台 打 印 的 信息 。 





s>java -jar selenium-server-standalone-2.41.0.jar -r 


May, 2014 5:43:52 PM org.openga.grid.selenium.GridLauncher main 
: Launching rr grid, ver 


2014-05-25 17:43:57. ] erver :jetty-7.x.y -SNAPSHOT 

2014-05-25 17:43 57.270: \ T 5 .ContextHandler :started 0.5.7] 

iHandler{/,null} 

2014-05-25 17:43:57.345:INF0:0sjs.AbstractConnector:Started SocketConnector@0.0. 
0.0:4444 
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当 我 们 以 hub 形 式 启 动 Server 之 后 ， 它 就 是 一 个 
Grid Servers IJE LUMIEN e e 
的 信息 ， 如 下 图 所 示 。 


d Grid Console 
€ > C [localhost4444/grid/console 


[.Jur- 
A 
> 


j| 
SG Grid Console v.2.41.0 





6.3.2 IITA 


现在 我 们 已 将 Selenium Server 作 为 Grid Server 
启动 ， 接 下 来 是 在 Server 上 添加 并 配置 节点 。 


6.3.2.1 ”添加 下 节点 


先 从 安装 有 Internet Explorer 的 Windows 节 点 开 
台 添 加 。 打 开 新 的 命令 行 或 终 端 窗口 并 定位 到 
Selenium Server JAR 包 文件 所 在 的 目录 。 输 入 以 下 
fir ao IP ESD A Grid. 





java -Dwebdriver.ie.driver="C:\SeDrivers\IEDriverServer 
.exe" -jar 

selenium-server-standalone-2.41.0.jar -role webdriver - 
browser 


"browserName-internet explorer,version-z10,maxinstance-1 
;platformzWINDOWS" 


-hubHost 192.168.1.103 -port 5555 





要 将 节点 添加 到 Grid， 我 们 需要 使 用 -role 参 数 
并 传递 值 “webdriver”， 还 需要 使 用 -browser 人 参数 配 
LIU Visa. fEXCT PIT m, 38xibrowserName 
指定 浏览 器 为 Internet Explorer， 版 本 为 10， 
maxinstance 为 1， 平 台 为 Windows。 其 中 
maxinstance 值 是 告诉 Grid 可 以 文 持 多 少 并 发 浏览 
实例 。 


要 将 节点 连接 到 hub 或 Grid Server， 我 们 还 需要 
4 5E -hubHost# Z4. 5 Grid Server 的 主机 名 或 耻 地 
Hb. 最 后 ， 指 定 节 点 承 可 以 连接 到 hub 上 对 应 的 端 
ae 





当 我 们 执行 上 述 命令 后 ， 市 点 将 被 局 动 ，Grid 
控制 全 上 会 出 现 如 下 图 所 示 的 配置 。 





_ 


Se Grid Console v.2.41.0 


DefaultRemoteProxy (version : 2.41.0) 
id : http://192.168.1.104:5555, OS : WINDOWS 


Browsers Kevin deir 


WebDriver 
v:10 








view config 


除了 上 面 的 方法 外 ， 也 可 以 通过 JSON 格 式 的 
配置 文件 来 添加 节点 。JSON 配 置 文件 代码 如 下 。 





"class": "org.openqa.grid.common.RegistrationRequest" 


"capabilities": [ 


{ 

"seleniumProtocol": "WebDriver", 
"browserName": "internet explorer", 
"version": "10", 

"maxInstances": 1, 

"platform" : "WINDOWS" 

} 

]; 

"configuration": ( 

"port": 5555, 


"register": true, 

"host": "192.168.1.103", 

"proxy": "org.openga.grid.selenium. proxy. DefaultRem 
oteProxy", 

"maxSession": 2, 


"hubHost": "192.168.1.100", 

"role": "webdriver", 

"registerCycle": 5000, 

"hub": "http://192.168.1.100:4444/grid/register", 
"hubPort": 4444, 

"remoteHost": "http://192.168.1.102:5555" 





我 们 可 以 在 命令 行 参 数 中 传递 JSON 配 置 文 
件 “selenium-node-win-ie10.cfg.json”， 下 面 就 是 通过 
JSON 配 置 文件 方式 局 动 Server 的 命令 。 





java -Dwebdriver.ie.driver="C:\SeDrivers\IEDriverServer 
.exe"-jar 


selenium-server-standalone-2.41.0.jar -role webdriver - 
nodeConfig 
selenium-node-win-ie10.cfg.json 





6.3.2.2 ”添加 Eirefox 节 点 


现在 开始 添加 Firefox 节 上 点。 打开 新 的 命令 行 或 
终端 窗口 ， 定 位 到 Selenium Server JAR 包 文件 所 在 
日 录 下 ， 输 入 以 下 命令 启动 节点 并 添加 全 Grid。 





java -jar selenium-server-standalone-2.41.0.jar -role w 
ebdriver -browser 


"browserName-firefox,version-27,maxinstance-2,platform- 
WINDOWS" -hubHost 
localhost -port 6666 





在 此 ， 我 们 设置 maxinstance 值 为 2， 也 就 是 告 
诉 Grid 可 以 同时 支持 两 个 Firefox 实 例 。Firefox 闻 点 
启动 后 ，Grid 控 制 台 就 会 出 现 如 下 图 所 示 的 配置 。 


edb/ (version : 2.41.0) 
: htt 





WebDriver 
v:2 


6.3.2.3 ”添加 Chrome 节 点 


接 下 来 添加 Chrome 玉 点。 打开 新 的 命令 行 或 终 


SU 2 


端 窗口 ， 定 位 到 Selenium Server JAR 包 文件 所 在 目 
录 下 ， 输 入 以 下 命令 启动 节点 并 添加 至 Grid。 





java -Dwebdriver.chrome.driver="C:\SeDrivers\chromedriv 
er.exe" -jar 


selenium-server-standalone-2.41.0.jar -role webdriver - 


browser 
"browserName-chrome, version=35,maxinstance=2, platform=W 
INDOWS" -hubHost localhost -port 7777 





下 图 是 Chrome 闻 点 启动 后 Grid 控 制 台 出 现 的 配 
置信 A o 


DefaultRemoteProxy (version : 2.41.0) 





id : http://192.168.1.104:7777, OS : WINDOWS 


Browsers KOs iTEC 


WebDriver 
v 35 


64 Mac OSX 的 Safari 节 点 


我 们 已 经 从 Windows 系 统 添 加 了 JI 了 、EFirefox 和 
Chrome 贡 点 ， 现 在 我 们 要 从 Mac 系 统 添加 一 个 
Safari 节 点 。 打 开 一 个 新 的 终端 窗口 ， 定 位 到 
Selenium Server JAR 包 文件 所 在 目录 下 ， 输 入 以 下 
命令 局 动 闻 点 并 添加 人 至 Grid。 








java -jar selenium-server-standalone-2.41.0.jar -role w 
ebdriver -browser 


"browserName-safari,version-7,maxinstance-1,platform-MA 
C" -hubHost 192.168.1.104 -port 8888 











下 图 是 该 节操 局 动 后 Grid 控 制 台 上 出 现 的 所 有 
配置 信息 。 





Se Grid Console v.2.41.0 








DefaultRemoteProxy (version : 2.41.0) DefaultRemoteProxy (version : 2.41.0) 
id : http://192.168.1.104:5555, OS : WINDOWS id : http://192.168.1.104:7777, OS : WINDOWS 
Browsers Kevin Browsers Revier 

WebDriver WebDriver 

v:106 v:35@ 

DefaultRemoteProxy (version : 2.41.0) DefaultRemoteProxy (version : 2.41.0) 
id : http://192.168.1.104:6566, OS : WINDOWS id : http://192.168.1.100:8888, OS : MAC 
Browsers wiicin Browsers 

WebDriver WebbDriver 

v:278 v:78 

view config 


现在 ， 我 们 配置 好 了 Selenium Grid, ERI] 
试 在 这 个 Grid 上 执行 测试 吧 。 


65 在 Grid 上 执行 测试 


在 配置 有 不 同 浏览 器 和 操作 系统 组 合 的 Grid 上 
执行 测试 之 前 ， 需 要 对 我 们 之 前 创建 的 测试 进行 一 
些 调整 。 之 前 设置 desired_capabilities 的 时 候 ， 我 们 
AWS TS Ee SM DAS ACE BAK WFR EEE A 
编码 了 ， 那 么 我 们 就 需要 为 每 个 组 合 都 单独 准备 一 
个 测试 脚本 。 为 了 避免 这 一 点 而 使 用 同一 个 测试 脚 
本 来 测试 所 有 的 组 合 ， 我 们 需要 参数 化 浏览 贷 和 平 
台 名 称 这 两 个 值 ， 然 后 传递 到 desired_capabilities 类 
中 ， 如 以 下 步骤 中 所 示 。 





C1) 从 命令 行 中 将 浏览 器 和 平台 的 值 传 递 给 
测试 脚本 。 人 例如， 如 果 要 在 Windows 和 Chrome 组 合 
上 执行 测试 ， 可 以 通过 以 下 方式 在 命令 行 中 运行 脚 


python grid_test.py WINDOWS chrome 





(2) 如 果 要 在 Mac 和 Safari 组 合 上 执行 测试 ， 
使 用 以 下 命令 运行 脚本 。 


python grid test.py MAC safari 


(3) 要 实现 这 一 点 ， 需 要 在 以 下 的 测试 类 中 
添加 PLATFORM 和 BROWSER 两 个 全 局 属性 ， 并 分 
别 设 置 一 个 默认 值 ， 以 防 从 命令 行 运行 脚本 时 没有 
提供 值 。 








class SearchProducts(unittest.TestCase): 


PLATFORM = 'WINDOWS' 
BROWSER = 'firefox' 








(4) 接 下 来 ， 在 setUp(0) 方 法 中 参数 化 这 些 
desired_capabilities， 如 下 和 面 的 代码 所 示 。 


desired caps = {} 
desired caps['platform'] = self.PLATFORM 





desired caps['browserName'] = self.BROWSER 


(5) 最 后 ， 读 取 命 令 行 参 数值 并 传递 给 脚 
本 ， 从 而 为 PLATFORM 和 BROWSER 属 性 赋值 。 


if name == ' main ': 
if len(sys.argv) » 1: 


SearchProducts.BROWSER = sys.argv.pop() 
SearchProducts.PLATFORM = sys.argv.pop() 
unittest.main() 





(60 网 是 这 样 。 现 在 我 们 的 测试 已 经 准备 好 
处 理 任何 给 定 的 环境 组 合 了 。 以 下 十 完整 代码 。 








import sys 
import unittest 
from selenium import webdriver 


class SearchProducts(unittest.TestCase): 
PLATFORM = 'WINDOWS' 
BROWSER = 'firefox' 


def setUp(self): 
desired caps = {} 
desired caps['platform'] = self.PLATFORM 
desired caps['browserName'] = self.BROWSER 


self.driver = \ 
webdriver.Remote('http://192.168.1.104:4444/ 
wd/hub', desired caps) 
self.driver.get('http://demo.magentocommerce.com 
/') 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


def testSearchByCategory(self): 
# get the search textbox 


self.search_field = self.driver.find_element_by_ 
name('q') 
self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys('phones') 
self.search field.submit() 


# get all the anchor elements which have product 
names 
# displayed currently on result page using 
it find elements by xpath method 
products = self.driver.\ 
find_elements_by_xpath('//h2[@class=\' produc 
t-name\' ]/a' ) 


# check count of products shown in results 
self .assertEqual(2, len(products) ) 


def tearDown(self): 
# close the browser window 
self .driver.quit() 


if name == ' main ': 
if len(sys.argv) » 1: 
SearchProducts.BROWSER = sys.argv.pop() 
SearchProducts.PLATFORM = sys.argv.pop() 
unittest.main(verbosity-2) 








(7) STF er aS f RA mA, EMEN 
本 所 在 位 置 的 目录 ， 输 入 以 下 命令 执行 测试 。 你 将 
看 到 Grid 会 目 动 连接 到 与 给 定 平 台 和 浏览 部 匹 配 的 





方太 并 在 该 节点 上 执行 测试 。 


python grid test.py MAC safari 


6.6 在 云端 执行 测试 





为 了 实现 路 浏览 厚 测 试 ， 我 们 在 之 前 的 步骤 中 
搭建 了 本 地 Grid。 搭 建 本 地 Grid 需要 给 物理 或 虚拟 
机 如 配置 不 同 浏览 上 融和 操作 系统 。 可 是 获取 这 些 便 
件 和 软件 设备 是 需要 很 大 的 成 本 和 努力 的 ， 而 且 你 
还 需要 在 这 些 设备 的 更 新 和 补丁 等 方面 投入 大 量 的 
精力 ， 这 不 是 每 个 人 或 团队 都 能 负担 得 起 的 。 








但 现在 你 可 以 轻松 地 将 虚拟 测试 lab 外 包 给 第 三 
方 云 测 试 提供 商 ， 而 不 必 兹 费 精 力 投 资 和 搭建 跨 浏 
tae wlliztlab. Sauce Labs 和 BrowserStack 是 领先 的 
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超过 400 种 不 同 的 浏览 器 和 操作 系统 配置 ， 包 括 移 
动 和 平板 设备 ， 并 文 持 在 他 们 的 云端 环境 中 运行 
Selenium WebDriver 测 试 。 











在 本 节 中 ， 我 们 将 在 Sauce Labs 中 安装 并 执行 


测试 。 用 BrowserStack 执 行 测试 的 步 又 也 是 类 似 
的 。 


下 面 我 们 使 用 Sauce Labs 搭 建 并 执行 测试 ， 步 
骤 如 下 。 


(1) 首先 需要 一 个 免费 的 Sauce Labs 账 号 。 可 
以 从 Sauce Labs 官 网 Chttps://saucelabs.com/) 注册 
费 账 号 ， 获 取 用 户 名 和 访问 密 钥 。Sauce Labs 在 
云 剖 环境 中 提供 了 执行 测试 所 需 的 所 有 便 件 和 软件 
等 基础 配置 。 





(2) 登录 后 从 Sauce Labs 主 页 获取 访问 密 钠 ， 
如 下 图 所 示 。 


Access Key 


| 


.| B 


27132c-ae27-4217-b6fa 


(3) 修改 之 前 Grid 中 运行 时 所 创建 的 测试 ， 


并 添加 步骤 使 其 可 以 运行 在 Sauce Labs E- 





(4) 在 测试 脚本 中 添加 Sauce 用 户 名 和 访问 密 
钥 ， 更 改 Grid 地 址 为 Sauce Grid 地 址 并 传递 该 用 户 
名 和 访问 密 钥 ， 如 下 面 代码 所 示 。 





import sys 
import unittest 
from selenium import webdriver 


class SearchProducts(unittest.TestCase): 
PLATFORM = 'WINDOWS' 
BROWSER = 'phantomjs' 
SAUCE USERNAME = 'upgundecha' 
SUACE KEY = 'c6e7132c-ae27-4217-b6fa-3cf7df0a37281' 


def setUp(self): 
desired caps = {} 
desired caps['platform'] = self.PLATFORM 
desired caps['browserName'] = self.BROWSER 


sauce string = self.SAUCE USERNAME + ':' + self. 
SUACE KEY 


self.driver = \ 
webdriver.Remote('http://' + sauce_string + 
"@ondemand.saucelabs.com:8@/wd/hub', desir 
ed_caps) 
self .driver.get( 'http://demo.magentocommerce.com 
/') 
self.driver.implicitly wait(30) 


self.driver.maximize window() 


def testSearchByCategory(self): 
# get the search textbox 
self.search_field = self.driver.find_element_by_ 
name('q') 
self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys('phones') 
self.search field.submit() 


# get all the anchor elements which have product 
names 

# displayed currently on result page using 

it find elements by xpath method 

products = self.driver.\ 


find_elements_by_xpath('//h2[@class=\' produc 
t-name\' ]/a' ) 


# check count of products shown in results 
self .assertEqual(2, len(products) ) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


if name == ' main ': 
if len(sys.argv) » 1: 
SearchProducts.BROWSER = sys.argv.pop() 
SearchProducts.PLATFORM = sys.argv.pop() 
unittest.main(verbosity-2) 








(50 打开 命令 行 或 终 剖 窗口 ， 进 入 脚本 所 在 


目录 ， 输 入 以 下 命令 执行 测试 。 


python sauce_test.py "OS X 10.9" "Safari" 





Q 
Hy Lb. 7Ehttps://saucelabs.com/platforms3k HX 
Sauce Labs 文 持 的 平台 列表 。 





测试 执行 时 ， 它 将 连接 到 Sauce Labs 的 Grid 
Server 并 请 求 所 需 的 操作 系统 和 浏览 妖 配 置 。Sauce 
为 我 们 的 测试 分 配 虚拟 机 并 在 给 定 的 配置 上 运行 。 








(6) 我 们 可 以 在 Sauce Dashboard 上 监视 执行 
状态 ， 如 下 图 所 示 。 











我 们 还 可 以 在 Sauce 会 话 部 分 进一步 了 解 测 试 
执行 过 程 中 客 竟 发 生 了 什么 。Sauce 会 话 页 面 显示 


了 测试 执行 的 细节 ， 包 括 Selenium 命 令 、 截 图 、 
Selenium 日 志 以 及 执行 过 程 的 和 截屏， 如 下 图 所 示 。 


unnamed job 


by upgundecha 











MADISON 


ISLAND 


也 可 以 用 Sauce Connect 在 内 部 服务 器 上 
更 安全 地 测试 你 的 应 用 程序 。Sauce Connect 
会 在 你 的 机 器 和 Sauce 云 中 创建 一 个 安全 的 通 


6.7 章节 回顾 


在 本 章 中 ， 我 们 学 习 了 如 何 使 用 Selenium 
Standalone Server 在 远程 机 器 上 执行 测试 。Selenium 
Standalone Server 能 够 在 远程 机 器 上 对 应 用 程序 进 
行 任意 浏览 器 和 操作 系统 组 合 的 蹈 浏览 需 测 试 。 这 
不 但 增加 了 测试 履 兰 率 ， 而 且 能 确保 应 用 程序 在 期 
望 的 组 合 上 执行 。 





然后 ， 我 们 搭建 了 Selenium Grid， 并 在 分 布 式 
架构 中 执行 测试 。Selenium Grid 可 以 在 对 多 个 机 器 
上 透明 地 执行 ， 从 而 降低 跨 浏 览 右 测试 的 复杂 性 ， 
也 减少 了 测试 执行 时 间 。 








我 们 还 考虑 了 基于 云 并 的 跨 浏 吃 器 测试 提供 
了 商 ， 在 Sauce Labs 上 执行 测试 。Sauce Labs 提 供 了 执 
行 测 试 所 需 的 所 有 基础 配置 ， 文 持 上 百 种 不 同 的 组 
合 ， 成 本 更 低 。 





在 下 一 章 中 ， 我 们 将 学 习 如 何 使 用 Appium 和 
Selenium WebDriver 测 试 移动 端 应 用 程序 ， 在 此 过 
程 中 会 用 到 一 些 本 章 中 学 习 到 的 概念 。Appium 文 持 
在 iOS 和 Android 系 统 上 测试 原生 、 混 合 以 及 移动 
Webi HFEF o RI TK Ezr H Appium XT F z tm 
试 的 示例 。 
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应 用 程序 已 经 渗透 到 消费 着 与 企业 市 场 。 无 论 是 小 
企业 还 是 大 企业 ， 在 使 用 移动 端 作为 连接 用 户 的 渠 
道 方面 都 潜力 巨大 。 大 家 都 努力 建设 显示 友好 的 移 
动 端 网 站 或 者 App 应 用 程序 ) 来 服务 客户 和 内 部 
员工 。 测 试 这 些 应 用 能 合 在 市 场 上 流行 的 各 种 移动 
端 设备 上 正常 运行 变 得 公关 重要 。 本 章 将 讲解 如 何 
使 用 WebDriver 和 Appium 来 测试 移动 问 应 用 程序 。 











本 草包 含 以 下 主题 : 


e 如 何 使 用 Appium 测 试 移动 端 应 用 ; 
e Appium 有 的 安装 和 配置 ， 


。 在 iPhone 模拟 器 上 创建 并 运行 iDS 测 试 ; 
。 在 真 机 上 创建 并 运行 Android 测 试 。 


7.1 认识 Appium 








Appium 是 一 个 开源 的 自动 化 测试 框架 ， 可 以 
用 来 测试 基于 iOS、Android 和 Firefox OS 平台 的 原 
生 与 混合 的 应 用 。 该 框架 使 用 Selenium 
WebDriver， 在 执行 测试 时 用 于 和 Selenium Server 
通信 的 是 JSON Wire Protocol。 在 Selenium 2 中 ， 
Appium 将 取代 iPhoneDriver 和 AndroidDriver API, 
并 用 于 测试 移动 互联 网 应 用 程序 。 





Appium 人 允许 我 们 使 用 ， 甚 至 扩展 现 有 的 
Selenium WebDriver 框 染 来 构建 测试 脚本 。 由 于 
Appium 是 通过 Selenium WebDriver 来 驱动 测试 脚本 
的 ， 因 此 只 要 有 对 应 的 Selenium client library 存 在 ， 
残 可 以 使 用 相应 的 语言 来 创建 测试 脚本 。 下 图 是 
Appium] A^ E F & AMH 2878 f] SCRETE DUE] 48. si 3 
Al. 








ios iPhone and iPad 


Hybrid g Emulator 
Supported App Types Appium Platforms Supports 


7.1.1 Appium 文 持 的 应 用 类 型 
Appium 文 持 以 下 应 用 类 型 的 测试 。 


。 原 生 应 用 。 原 生 应 用 是 指 适用 于 特定 平台 的 ， 
即使 用 该 平台 所 支持 的 语言 和 框架 来 构建 的 。 
例如 ，iPhone 和 iPad 上 面 的 应 用 都 是 使 用 
Objective-C 和 iOS SDK 来 开发 的 ， 同 样 ， 
Android 应 用 是 使 用 Java 和 Android SDK 来 开发 
的 。 在 程序 运行 的 时 候 ， 原 生 应 用 会 更 加 流畅 
和 稳定 。 它 们 是 使 用 原生 框架 来 构建 用 户 交 互 
界面 。 

。 移 动 端 Web 应 用 。 移 动 端 Web 应 用 是 服务 端 应 
用 ， 是 使 用 PHP、Java 或 者 ASP.NET 这 样 的 服务 














gt AN RP) EEN, J ALAS jQuery Mobile, 
Sencha Touch 55— 613; ZR T 248 HP? va rf] PASSI 
本 地 UTI。 

混合 应 用 。 类 似 于 原生 应 用 程序 ， 混 合 应 用 是 
运行 在 移动 设备 上 并 且 通 过 一 些 互 联网 技术 
CHTML5、CSS 和 JavaScript) 来 实现 的 。 混 合 
应 用 使 用 移动 设备 的 浏览 器 引 苟 来 泻 染 HTML 页 
面 ， 并 且 通 过 使 用 WebView 在 本 地 容器 中 处 理 
JavaScript 脚 本。 这 种 处 理 方式 可 以 使 混合 应 用 
具备 访问 一 些 移动 Web 应 用 不 能 访问 的 设备 
《比如 相机 、 加 速 计 、 传 感 器 和 本 地 存储 器 ) 
的 能 








7.1.2 Appium 环 境 ;准备 





在 开始 学 习 更 多 关于 Appium 的 知识 之 前 ， 首 
^uid fk — LEZE FiOS Fl Android“ & BJ LE. 


Appium 是 基于 Node.js 实 现 的 ， 在 Mac OS 
X 和 Windows 平 台 上 都 有 对 应 的 Standalone 
GUIK Node.js 包 。 我 们 可 以 使 用 Mac OS XF 
人 台 上 内 置 在 Node.js 框 架 内 的 Appium 
Standalone GUI. 





7.1.2.1 安装 Xcode 


我 们 需要 在 Mac OS XA EEH Xcode 4.6.3 或 
者 更 高 的 版 本 ， 来 测试 iDOS 平 台 下 的 应 用 。 


写本 书 时 ， 使 用 的 是 Xcode 5.1 版 本 。 可 以 在 
App Store 或 者 平 果 开 发 者 网 站 下 载 : 
https://developer.apple.com/xcode/。 


安装 完 Xcode 后 ， 从 应 用 程序 菜单 局 动 它 ， 然 
后 单 击 Preferences | Downloads。 安 装 Command Line 
Tools 和 其 他 的 iOS SDK， 用 来 测试 在 不 同 版 本 iOS 








平台 下 的 应 用 程序 ， 如 下 图 所 示 。 
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为 了 在 真 机 上 运行 测试 脚本 ， 需 要 首先 安装 好 
Provision Profile， 并 且 打 开 USB 调 试 模 式 。 


局 动 iPhone 模拟 器 并 验证 其 是 否 正 党 工作 。 可 
LNM Xcode | Open Developer Tool | iOS 
Simulator 来 启动 模拟 器 。 在 模拟 右 中 启动 Safari 浏 
览 苍 ， 并 且 打 开 如 下 图 所 示 Web 应 用 的 样 例 。 





7.1.2.2 ”安装 Android SDK 


我 们 需要 安装 Android SDK Kil Android V 
用 。 从 以 下 网 址 可 以 获取 最 新 版 本 的 Android 
SDK: http://developer.android.com/sdk/. 248 56M 
以 后 ， 确 保 ANDROID_HOME 已 经 成 功 添加 到 环境 
变量 的 path 中 。 





完整 安装 步骤 参考 : 
http://developer.android.com/sdk/installing/index.html? 


pkg=tools. 


有 关 最 新 的 Appium 安 装 要 求 和 细节 ， 请 
访问 相关 网 站 了 解 。 
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7.1.2.3 %3 Appium Python client 


在 完成 此 书 时 ，Appium Python client 是 完全 符 
合 Selenium 3.0 规 范 草 案 的 。 这 有 助 于 更 加 方便 地 使 
用 Python 和 Appium 来 编写 移动 端 测试 脚本 。 可 以 通 
过 以 下 命令 来 安装 Appium Python client。 


pip install Appium-Python-Client 


可 以 访问 以 下 网 址 查看 更 多 关于 Appium 
Python client 安装 包 的 信息 : 
https://pypi.python.org/pypi/Appium-Python- 
Client. 





7.2 XS Appium 


在 使 用 Appium 测 试 移动 应 用 之 前 ， 我 们 首先 
需要 下 载 和 安装 Appium。 我 们 选择 安装 Appium 
GUI 版 。 如 果 希 望 在 iPhone 或 者 Pad 上 运行 iDOS 测 
ih, ALA ait ETE A Mac OS X AZM ALAS EAE 
Appium。 如 果 是 测试 Android 应 用 程序 ， 需 要 在 装 
有 Windows 或 者 Linux 系 统 的 机 右上 安装 Appium。 

在 Mac OS X 系 统 上 安装 Appium 是 非常 简单 的 。 可 
以 从 以 下 网 址 下 载 最 新 版 本 的 Appium 安 装 文 件 : 
http://appium.io/. 





具体 安装 步骤 如 下 。 


(1) 在 网 站 首页 单 击 Download Appium?Z 
钮 ， 即 可 和 直接 跳 转 到 下 载 页 面 ， 如 下 图 所 示 。 
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Introducing Appium. F 


(20 从 列表 中 选择 你 正在 使 用 的 操作 系统 对 
应 的 安 疼 版 本 ， 如 下 图 所 示 。 


在 下 面 的 例子 中 ， 我 们 将 在 Mac OS X 系 
统 上 使 用 Appium。 





(3) 在 Mac 系 统 中 ， 可 以 通过 运行 安装 程序 
来 安装 Appium， 并 且 把 Appium 复 制 到 Applications 


Hox P. 


€ C |B Atlassian, Inc. [US] https;//bitbucketorg/appium/appium.app/downlozds/ wa i!lt 
iii Apps [7] Selenium [J Agile CJ Symantec (7j Testing CJ Apple/iOS CJ Web Sample VBScripts«... (9 DiscoRobo » Other bookm 


Atlassian 





加 Bitbucket Features Pricing e Sit 、 English ~ Sign up 


© Downloads 


Downloads Tags Branches 


ail Name Size Uploaded by Downloads Date 

目 Download repository 77.7 MB 

fe) Appium-1.3.0 (Beta 1).zip 139.9 MB appium 1168 2014-10-16 

v AppiumForWindows-1.2.4.1.zip 51.8 MB astro03 4116 2014-10-07 

fy AppiumF orWindows.zip 51.8 MB astro03 686 2014-10-07 

ge Appium-1.3-beta.zip 134.4 MB appium 855 2014-10-05 
AppiumForWindows-1.2.3.1.zip 51.8 MB astro03 2197 2014-09-25 
appium.dmg 47.9 MB dcuellar 1742 2014-08-28 
appium-1.2.2.dmg 47.9 MB dcuellar 9716 2014-08-28 
appium-1.2.1.dmg 41.3 MB dcuellar 2888 2014-08-22 
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&C 


默认 情况 下 ，Appium 局 动 后 的 URL 和 端 
口 是 http://127.0.0.1:4723 或 localhost。 该 URL 
正 是 测试 脚本 发 指令 对 应 的 地 址 。 我 们 将 基 
于 iPhone 的 Safari 浏 览 器 来 测试 本 书 中 的 样 例 


| 


(4) 在 如 下 图 所 示 的 Appium 的 主 界面 ， 单 击 
Apple 图 标 ， 打 开 iOS 设 置 对 话 框 。 





(5) 在 iOS 设 置 对 话 框 中 ， 选 中 Force Device 
复 选 枉 ， 并 且 在 下 拉 列 表 中 选择 iPhone 型 号 。 另 
外 ， 选 中 Use Mobile Safari 复 选 枉 ， 如 下 图 所 示 。 


(6) 在 Appium 主 界面 ， 单 击 Launch 按 钮 启动 


Appium Server. 


Inspector 元 素 定位 器 : Appium 的 元 素 定 位 工具 
I| Appium Inspector， 可 以 通过 在 Appium 主 界面 单 
击 放大 镜 的 图 标 来 局 动 它 。 





该 定位 天 可 供 了 定位 被 测 应 用 的 多 种 分 析 方 
式 。 其 中 主要 的 特性 就 是 告诉 我 们 这 些 UI 元 素 在 移 
动 应 用 程序 中 是 如 何 补 使 用 的 ， 包 括 它们 的 层次 结 
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定位 右 。 它 也 可 以 模拟 应 用 程序 上 的 各 种 操作 手 
势 ， 并 看 到 在 模拟 部 上 执行 的 效 末 。 它 还 能 够 记录 
下 用 户 在 移动 应 用 上 的 操作 步骤 。 
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Xcode Path | Change |) Macintosh HD Sd Applications 51$! Xcode | 





7.3 iOsyllix 


Appium 使 用 多 种 自 带 上 自动 化 测试 框架 来 驱动 
测 斌 执行， 并且 文 持 基 于 Selenium WebDriver JSON 
无 线 协议 的 API 调 用 。 对 于 ioOS 应 用 程序 的 目 动 化 测 
试 ，Appium 是 利用 Apple 组 件 之 一 的 UI Automation 
特性 来 实现 的 。 


Appium 作为 一 个 HITP Server 来 接收 测试 脚本 
通过 JSON Wire Protocol 传 输 过 来 的 指令 。Appium 
发 送 这 些 指令 给 Apple 组 件 。 这 样 ， 这 些 指 令 束 可 
以 在 局 动 了 被 测 应 用 的 模拟 器 或 者 真 机 上 执行 测 
试 。 这 个 过 程 中 ，Appium 把 JSON 指 令 翻译 成 UIl 
Automation 能 够 理解 的 JavaScript 命 令 。Ul 
Automaiton 负 员 在 模拟 器 或 者 真 机 上 启动 和 关闭 应 
用 程序 。 这 个 过 程 如 下 图 所 示 。 
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f. 
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当 在 模拟 器 或 者 真 机 的 应 用 程序 上 执行 测试 指 
令 的 时 候 ， 被 测 应 用 程序 会 友 送 啊 应 给 UI 
Automation， 然 后 以 JavaScript 的 啊 应 格式 返回 给 
Appium。Appium 再 把 UT Automation JavaScript! by 
BJ FE RAY GB Selenium WebDriver JSON Wire Protocol 
的 啊 应 信息 ， 并 把 它 返 回 给 测试 脚本 。 


现在 ， 我 们 已 经 成 功 启 动 了 Appium， 接 下 来 
创建 一 个 基于 iPhone Safari 浏 览 器 ， 检 查 Web 应 用 
搜索 功能 的 测试 用 例 。 创 建 一 个 新 的 测试 类 
SearchProductsOnIPhone， 人 代码 如 下 。 





import unittest 
from appium import webdriver 


class SearchProductsOnIPhone(unittest.TestCase): 
def setUp(self): 
desired caps = {} 


# platform 


desired caps['device'] = ‘iPhone Simulator ' 
# platform version 

desired caps['version'] = '7.1' 

# mobile browser 

desired caps['app'] = 'safari' 


# to connect to Appium server use RemoteWebDrive 


# and pass desired capabilities 
self.driver = \ 
webdriver.Remote("http://127.0.0.1:4723/wd/h 


ub", desired caps) 


/") 


self.driver.get("http://demo.magentocommerce.com 


self.driver.implicitly wait(30) 
self.driver.maximize window() 


def test search by category(self): 


name("q 


names 


# click on search icon 
self.driver.find element by xpath 
("//a[@href='#header-search' |").click() 

# get the search textbox 

self.search_field = self.driver.find_element_by_ 
") 

self.search_field.clear() 

# enter search keyword and submit 
self.search_field.send_keys("phones") 
self.search_field.submit() 


# get all the anchor elements which have product 
# displayed currently on result page using 


# find_elements_by_xpath method 
products = self.driver\ 


.find elements by xpath 
("//div[@class='category-products' ]/ul/1i") 


# check count of products shown in results 
self .assertEqual(2, len(products) ) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


if name == ' main ': 
unittest.main(verbosity-2) 





需要 使 用 RemoteWebDriver 来 调用 Appium 执 行 
测试 用 例 。 为 了 在 期 望 的 平台 上 使 用 Appium， 需 要 
执行 以 下 代码 。 
desired caps 


# platform 


desired caps['device'] = ‘iPhone Simulator' 
# platform version 


desired caps['version'] = '7.1' 
# mobile browser 
desired caps['app'] = 'safari' 





desired caps['device'] 命令 是 用 Appium 来 指定 
在 哪个 平台 上 运行 测试 脚本 。 上 面 的 例子 中 ， 是 使 
用 iPhone 模拟 需 。 如 果 要 在 iPad 上 执行 测试 ， 那 么 


就 要 指定 iPad 模拟 器 。 


当 在 真 机 上 运行 测试 脚本 时 ， 需 要 为 
desired_caps["device'] 赋 值 为 也 hone 或 者 iPad。 
Appium 会 选择 通过 USB 连 接 到 Mac 电 脑 上 的 设备 来 
执行 脚本 。 


desired_caps['version'] 命 令 用 来 设置 iPhone/iPad 
模拟 器 的 版 本 。 上 面 的 例子 中 ， 使 用 的 是 iOS 7.1/5 
本 的 模拟 器 ， 访 版 本 在 写本 书 的 时 候 是 iO0S 的 最 新 
版 本 。 





desired_caps['app'] 用 来 设置 要 局 动 的 目标 应 
用 。 上 面 的 例子 中 ， 启 动 的 是 Safari 浏 览 器 。 
最 后 ， 需 要 通过 RemoteWebDriver 连 接 到 


Appium Server， 并 且 设 置 好 相应 的 配置 。 下 面 是 创 
& — "Remote 实例 的 代码 。 


self.driver = webdriver.Remote 





("http://127.0.0.1:4723/wd/hub", desired caps) 








后 面 的 测试 脚本 用 来 调用 Selenium API 实 现 与 
应 用 的 交互 操作 。 运 行 测 试 过 程 中 ， 将 会 看 到 
Appium 通 过 测试 脚本 建立 会 话 ， 并 在 iPhone 模拟 器 
EEs Safarit HFEF. Appium RZ ERM aS i M 
中 一 步 步 地 执行 对 于 Safari 应 用 的 测试 。 





7.4 Android 测试 


Appium 对 于 Android 应 用 程序 的 测试 是 通过 调 
用 内 置 在 Android SDK 中 的 UI Automator 来 实现 
的 。 过 程 非 党 类 似 于 基于 iOS 平 台 的 测试 。 


Appium 作为 一 个 HITP Server 来 接收 测试 脚本 
通过 JSON Wire Protocol 传 输 过 来 的 指令 。Appium 
发 送 这 些 指 令 给 UI Automator. FE, ixU5j484 RI 
可 ie 动 了 被 测 应 用 的 模拟 器 或 者 真 机 上 执行 测 
试 。 这 个 过 程 中 ，Appium 把 JSON 指 令 翻 译 成 UI 
Automator 能 够 理解 的 Java 命 令 。 这 个 过 程 如 下 图 
所 示 。 
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当 在 模拟 器 或 者 真 机 的 应 用 程序 上 执行 测试 指 
令 的 时 候 ， 被 测 应 用 程序 会 友 送 啊 应 给 UI 
Automator， 然 后 返回 给 Appium。Appium 再 把 UI 
Automator 吧 应 翻译 成 符合 Selenium WebDriver 
JSON Wire Protocol 的 啊 应 信息 ， 并 把 它 返 回 给 测试 
脚本 。 


在 Android 平 台 上 测试 一 个 应 用 程序 和 在 iOS 平 
台 上 的 操作 非常 相似 。 一 般 在 Android 平 台 ， 我 们 
会 使 用 真 机 来 取代 模拟 器 《与 iOS 平 台 的 simulator 
不 同 ， 在 Android 社 区 被 称 为 emulator) 。 下 面 将 使 
用 同样 的 程序 来 测试 Android 平 台 下 的 Chrome 浏 览 
AF o 











在 本 次 测试 中 ， 将 使 用 Samsung Galaxy S II 型 
号 的 手机 。 汕 试 之 前 首先 要 安装 好 Chrome 浏 览 器 。 
Chrome 浏 览 器 可 以 从 应 用 商店 下 载 。 然 后 需要 把 该 
手机 连接 到 运行 有 Appium 的 电脑 上 。 
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是 在 Android 真 机 上 执行 测试 脚本 的 ， 首 先 要 确保 
手机 已 经 成 功 安装 了 Chrome 浏 览 器 并 且 成 功 连接 到 
电脑 上 了 。 运 行 下 面 的 命令 可 以 获取 连接 到 电脑 上 
的 虚拟 机 和 真 机 的 列表 。 


Android Debug Bridge(adb) 是 内 置 在 Android 
SDK 中 的 命令 行 工 具 ， 通 过 它 可 以 与 模拟 器 实例 或 
者 真 机 进行 通信 。 








上 面 的 命令 可 以 获取 到 已 经 连接 到 主机 上 的 
Android 设 备 列表 。 如 下 图 所 示 ， 可 以 看 到 在 上 面 
的 例子 中 已 经 建立 连接 的 真 机 。 
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我 们 可 以 修改 前 面 为 OS 测试 写 过 的 脚本 ， 使 
其 能 够 在 Android 平 台 运 行 。 创 建 一 个 新 的 测试 类 
SearchProductsOnAndroid。 复 制 下 面 的 代码 到 新 创 
建 的 测试 类 中 。 





import unittest 
from appium import webdriver 


class SearchProductsOnAndroid(unittest.TestCase): 
def setUp(self): 
desired caps = {} 
# platform 
desired caps['device'] = ‘Android’ 
# platform version 


desired caps['version'] = '4.3' 
# mobile browser 
desired caps['app'] = 'Chrome' 


# to connect to Appium server use RemoteWebDrive 
# and pass desired capabilities 


self.driver = \ 
webdriver.Remote("http://127.0.0.1:4723/wd/h 


ub", desired caps) 


/") 


self.driver.get("http://demo.magentocommerce.com 


self.driver.implicitly wait(30) 


def test search by category(self): 


name("q 


names 


# click on search icon 
self.driver.find element by xpath 

("//a[Qhrefz 'stheader-search']").click() 
# get the search textbox 
self.search_field = self.driver.find_element_by_ 
") 


self.search_field.clear() 


# enter search keyword and submit 
self.search_field.send_keys("phones") 
self.search_field.submit() 


# get all the anchor elements which have product 


# displayed currently on result page using 
# find_elements_by_xpath method 
products = self.driver\ 
.find_elements_by_xpath 
("//div[@class='category-products']/ul/li") 


# check count of products shown in results 
self .assertEqual(2, len(products) ) 


def tearDown(self): 
# close the browser window 
self .driver.quit() 


if name == ' main ': 
unittest.main(verbosity=2) 





在 该 实例 中 ， 我 们 给 desired_caps['device'] 指 定 
的 值 是 Android， 表 明 将 会 在 Android 平 台 上 运行 测 
试 o 


接 下 来 ， 可 以 看 到 desired_caps["version] 设 置 的 
Android 4.3 版 本 (Jelly Bean) 。 需 要 在 Android 
系统 的 Chrome 浏 览 器 上 执行 测试 ， 因 此 
desired_caps['app'] 设 置 的 值 是 Chrome。 


Appium 将 会 调用 通过 adb 返 回 的 设备 列表 中 的 
第 一 个 来 运行 测试 ， 并 通过 前 面 提 到 的 配置 ， 来 实 
现在 目标 设备 上 局 动 Chrome 浏 览 右 ， 然 后 开始 执行 
测试 脚本 ， 如 下 图 所 示 。 





IP Address: Port: Use Remote Server | v Q Stop 








ios EXT 


: Starting Appium in pre-launch mode 
: Pre-launching app 
: Looks like we want chrome on android 
: Creating new appium session a665c5af-c50a-483f-af46-05235a27a7195 
: Trying to find a connected android device 
: [ADB] Getting connected devices... 
executing: adb devices 
[ADB] 1 device(s) connected 


: Setting device id to 4df726365fc021e9 


debug: Pushing unlock helper app to device... 


debug: executing: adb -s 4df726365fc021e9 install "/Applications/Appium.app/ 
Contents/Resources/node modules/appium/build/unlock apk/unlock apk-debug.apk" 





Clear 


下 和 面 是 在 真 机 上 运行 测试 脚本 时 的 截图 。 





demo.magentocommerce.com 加 demo.magentocommerce.com/cata 加 
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7.5 ”使 用 Sauce Labs 


在 第 6 章 讲 到 器 浏 览 器 测试 时 ， 己 经 提 到 了 
Sauce Labs。Sauce 也 文 持 通过 Appium 来 测试 移动 端 
应 用 程序 。 事 实 上 ，Appium 本 和 里 就 是 由 Sauce Labs 
来 开发 和 支持 的 项 目 。 通 过 非常 小 的 配置 修改 ， 右 
可 以 在 Sauce Labs 上 运行 移动 新 的 测试 脚本 ， 代 码 
如 下 。 








import unittest 
from appium import webdriver 


class SearchProductsOnIPhone(unittest.TestCase): 
SAUCE USERNAME = 'upgundecha' 
SUACE KEY = 'c6e7132c-ae27-4217-b6fa-3cf7df037281' 


def setUp(self): 
desired caps = {} 


desired caps['browserName'] = "Safari" 

desired caps['platformVersion'] = "7.1" 

desired caps['platformName'] = "iOS" 

desired caps['deviceName'] = "iPhone Simulator" 
sauce string = self.SAUCE USERNAME + ':' + self. 


SUACE KEY 


_caps) 


/') 


self.driver = \ 
webdriver.Remote('http://' + sauce string + 
‘@ondemand.saucelabs.com:80/wd/hub', desired 


self.driver.get('http://demo.magentocommerce.com 


self.driver.implicitly wait(30) 
self.driver.maximize window() 


def test search by category(self): 


# click on search icon 
self.driver.find element by xpath("//a[Qghref- 
'#header-search' ]").click() 

# get the search textbox 

self.search_field = self.driver.find_element_by_ 


name("q") 


self.search field.clear() 


# enter search keyword and submit 
self.search field.send keys("phones") 
self.search field.submit() 


# get all the anchor elements which have 

# product names displayed 

# currently on result page using 

it find elements by xpath method 

products = self.driver\ 
.find elements by xpath 
("//div[@class='category-products' ]/u1/1i") 


# check count of products shown in results 
self.assertEqual(2, len(products)) 


def tearDown(self): 


# close the browser window 
self.driver.quit() 


if name == ' main ': 


unittest.main(verbosity-2) 





当 执 行 完 移动 端 测试 以 后 ， 可 以 在 Sauce Labs 
的 面板 上 看 到 运行 的 结果 和 录像 回放 。Sauce Labs 
上 有 很 多 现成 的 SDK 的 组 合 和 设置 ， 在 Sauce Labs 
执行 测试 可 以 节省 大 量 用 在 本 地 环境 配置 Appium 的 
时 间 和 精力 。 








7.6 ”章节 回顾 





本 章 我 们 学 习 了 如 采 在 移动 设备 上 测试 应 用 程 
序 。 我 们 了 解 了 Appium， 它 已 经 成 为 Selenium 用 来 
测试 移动 端 应 用 程序 的 一 个 核心 特性 。 我 们 完成 了 
Appium 的 安装 和 配置 ， 并 且 通 过 它 测 试 了 本 书 的 样 
例 程序 的 移动 端 版 本 。 





我 们 分 别 在 iPhone 模拟 需 和 Android 设 备 上 测试 
移动 互联 网 程序 。 通 过 使 用 Appium， 我 们 可 以 使 用 
任何 一 种 有 WebDriver 类 库 的 编程 语言 来 测试 各 类 
Me m DY. FA EE FF e 





在 下 面 章 节 中 ， 将 会 讲解 一 些 恨 好 的 编码 实 
践 ， 比 如 通过 Selenium WebDriver 来 实现 Page 
Object 模 式 和 数据 驱动 测试 。 
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本 章 将 介绍 两 类 重要 的 设计 模式 ， 这 些 设计 模 
式 有 助 于 提升 我 们 目 动 化 测试 框架 的 可 扩展 性 与 可 
维护 性 。 我 们 将 一 起 学 习 如 何 用 数据 驱动 的 模式 结 
合 Python 库 去 构建 Selenium 测 试 脚 本 。 


在 本 草 的 第 二 部 分 ， 我 们 还 将 学 习 用 Page 
Object 的 模式 创建 高 可 维护 与 健壮 性 的 测试 脚本 。 
将 元 素 定 位 器 和 底层 调用 从 测试 脚本 中 分 离 出 来 形 
成 抽象 层 ， 如 同 实 现 应 用 程序 的 各 个 功能 〈 就 像 用 
户 在 浏览 器 窗口 中 体验 到 的 内 容 一 样 ) 。 














本 章 包含 以 下 主题 


。 什 么 是 数据 驱动 测试 ; 


e 如何 用 数据 张 动 的 模式 〈ddt) 库 结 合 unittest 库 
构建 数据 驱动 测试 ; 

。 什么 是 Page Object 模 式 以 及 如 何 使 用 该 模式 创建 
维护 性 好 的 测试 ; 

。 结 合 测试 样 例 实现 一 个 Page Object 模式 的 测试 。 





8.1 ”数据 驱动 测试 


通过 使 用 数据 驱动 测试 的 方法 ， 我 们 可 以 在 需 
要 验证 多 组 数据 的 测试 场景 中 ， 使 用 外 部 数据 源 实 
现 对 输入 值 与 期 望 值 的 参数 化 ， 从 而 避免 在 测试 中 
仅 使 用 硬 编码 的 数据 。 





这 种 方法 对 于 测试 步 又 相同 而 使 用 不 同 的 “ 输 
入 值 与 期 望 值 ” 的 测 话 场 景 尤其 适用 。 下 雪 列 举 了 
一 个 用 于 验证 登录 场景 的 数据 组 合 。 














场景 描述 测试 数据 


不 党 登录 了 中 成 功 查 
有 效 的 用 户 名 和 密码 | 一 组 有 效 的 用 户 名 和 密码 且 收 到 成 功 提 









































昌 户 名 和 和 密码 ”| 一 组 无 效 的 用 户 名 和 密码 用 户 收 到 登录 失败 的 信息 











有 效 的 用 户 名 与 无 效 的 | 一 个 有 效 的 用 户 名 与 一 个 无 效 
密码 的 密码 





用 户 收 到 登录 失败 的 信息 





RITR m BE AS aT RETE EE 
测试 数据 和 条 件 的 各 个 组 合 。 


使 用 数据 驱动 的 模式 ， 根 据 业 务 逻 辑 分 解 测 试 
数据 ， 并 且 定 义 变 量 ， 使 用 外 部 的 CSV 或 表格 里 的 
数据 使 其 参数 化 ， 从 而 避免 使 用 原 测试 脚本 中 国定 
的 数据 。 这 种 方式 可 以 将 测试 脚本 与 测试 数据 分 
离 ， 使 得 测试 脚本 在 不 同 数据 集合 下 电 度 复 用 。 




















数据 驱动 的 模式 不 仅 可 以 帮助 我 们 增加 类 似 复 
杂 条 件 场 隶 的 训 试 覆 囊 ， 还 可 以 极 大 地 减少 我 们 对 
测试 代码 的 编写 和 维护 工作 量 。 





接 下 来 的 部 分 ， 我 们 将 改 用 Python ddt 库 ， 以 
数据 驱动 的 模式 创建 前 面 章 节 已 经 实现 过 的 测试 。 


8.2 ”使 用 ddt 执 行 数 据 驱 动 测 试 


ddt 的 库 可 以 将 测试 中 的 变量 进行 参数 化 。 例 
如 ， 我 们 可 以 通过 定义 一 个 数组 来 实现 数据 驱动 测 
试 。 


ddt 的 库 包 含 一 组 类 和 方法 用 于 实现 数据 驱动 
测试 。 


8.2.1 安装 ddt 
可 以 使 用 下 面 的 命令 来 下 载 与 安装 ddt。 


更 多 有 关 ddt 的 信息 可 以 访问 
https://pypi.python.org/pypi/ddt. 


8.2.2 ”设计 一 个 简 蛙 的 数据 驱动 测试 


我 们 将 一 个 之 前 使 用 数据 便 编码 的 搜索 场景 测 
试 ， 转 换 成 用 数据 驱动 模式 进行 测试 ， 并 且 使 得 肢 
本 可 以 搜索 多 种 类 别 的 商品 。 


为 了 创建 数据 驱动 测试 ， 我 们 需要 在 测试 类 上 
使 用 @ddt 装 饰 符 ， 在 测试 方法 上 使 用 @data 装 饰 
人 条。@data 装 饰 从 把 参数 当 作 测试 数据 ， 参 数 可 以 
是 单个 值 、 列 表 、 元 组 、 字 典 。 对 于 列表 ， 需 要 用 
@unpack 装 饰 符 把 元 组 和 列表 解析 成 多 个 参数 。 











接 下 来 实现 这 个 搜索 测试 ， 传 入 搜索 关键 词 和 
期 望 结果 ， 代 人 码 如 下 。 





import unittest 
from ddt import ddt, data, unpack 
from selenium import webdriver 


@ddt 
class SearchDDT(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 


£3) 


# specify test data using @data decorator 
@data(("phones", 2), ("music", 5)) 

@unpack 

def test_search(self, search_value, expected_count) 


# get the search textbox 

self.search_field = self.driver.find_element_by_ 
name("q") 

self.search field.clear() 

# enter search keyword and submit. 

# use search value argument to pass data 

self.search field.send keys(search value) 

self.search field.submit() 


# get all the anchor elements which have 

# product names displayed 

# currently on result page using 

it find elements by xpath method 

products = self.driver.find elements by xpath 
("//h2[Qclass-'product-name']/a") 


# check count of products shown in results 
self.assertEqual(expected count, len(products)) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


if name == ' main ': 
unittest.main(verbosity-2) 





TE ET BASH, Sel EG data iif HIE 
组 列表 作为 参数 ， 紧 接着 在 @unpack 装 饰 从 中 把 元 
组 解析 成 多 个 参数 。 在 test_search() 方 法 中 ， 
search_value 与 expected_count 两 个 参数 用 来 接收 元 
组 解析 的 数据 。 


# specify test data using @data decorator 
@data(("phones", 2), ("music", 5)) 


@unpack 
def test search(self, search value, expected count): 








当 我 们 运行 测试 脚本 的 时 候 ，ddt 把 测试 数据 
转换 为 有 效 的 Pyhotn 标 识 从 ， 生 成 名 称 更 有 意义 的 
测试 方法 。 例 如 上 面 的 测试 ，ddt 将 生成 如 下 图 展示 
的 方法 名 。 








m 


Mi Version 6.2.9200] 
( poration. All rights reserved. 


C:\Users\amitr>ced C:\Users\amitr\Desktop\Mrunmayee\Final\setests_final 


e\Final\setests_final>python SearchDDT.py 
(__main__.SearchDDT) ... ok 
a 


iC: \Users\amitr\Desktop\Mrunmayee\Final\setests_final>, 





8.3 ”使 用 外 部 数据 的 数据 驱动 测试 





在 先前 的 例子 里 ， 我 们 在 脚本 中 下 接近 供 了 测 
试 数据 。 然 而 ， 有 时 你 会 发 现 所 需要 的 测试 数据 在 
测试 脚本 外 部 已 经 存在 了 ， 谱 如 一 个 文本 文件 、 电 
子 表格 或 是 数据 库 。 这 可 以 使 得 我 们 的 测试 脚本 与 
测试 数据 分 离开 来 ， 可 以 方便 我 们 每 次 更 新 与 维护 
测试 脚本 ， 而 不 用 担心 测试 数据 。 








下 面 我 们 一 起 学 习 如 何 信 助 外 部 的 CSV GES 
分 隔 值 ) 文件 或 是 Excle 表 格 数据 来 实现 ddt。 





8.3.1 通过 CSV 获 取 数 据 


结合 前 面 的 测试 脚本 ， 我 们 在 @data 装 饰 符 中 
使 用 解析 的 外 部 的 CSV Ctestdata.csv) 来 换 掉 之 前 
的 测试 数据 。 其 中 CSV 数 据 文件 如 下 图 所 示 。 





File Edit Format View Help 





KategoryorProduct ,NumberOfProducts 
phones, 2 

music,5 

iphone 5s,0 


接 下 来 ， 我 们 在 @data 装 饰 从 中 实现 get_data() 
方法 ， 其 中 包括 路 径 、CSV 文 件 名 。 这 个 方法 调用 
CSV 库 去 读 取 文件 并 用 返回 一 行 数据 。 





import csv, unittest 
from ddt import ddt, data, unpack 
from selenium import webdriver 


def get_data(file_name): 
# create an empty list to store rows 
rows = [] 
# open the CSV file 
data_file = open(file_name, "rb") 
# create a CSV Reader from CSV file 
reader = csv.reader(data_file) 
# skip the headers 
next(reader, None) 
# add rows from reader to list 
for row in reader: 
rows .append(row) 
return rows 


@ddt 
class SearchCsvDDT(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 


/") 


# get the data from specified csv file by 

# calling the get data function 
@data(*get_data("testdata.csv")) 

@unpack 

def test_search(self, search_value, expected_count) 


self.search field =self.driver.find_element_ 
by name("q") 
self.search field.clear() 


# enter search keyword and submit. 
self.search field.send keys(search value) 
self.search field.submit() 


# get all the anchor elements which have 

# product names displayed 

# currently on result page using 

it find elements by xpath method 

products = self.driver.find elements by xpat 


("//h2[Qclass-'product-name']/a") 
expected count - int(expected count) 
if expected count » 9: 
# check count of products shown in resul 


ts 

self.assertEqual(expected_count, len(pro 
ducts) ) 

else: 

msg = self.driver.find_element_by_class_ 
name ("note-msg") 

self.assertEqual ("Your search returns n 
o results.", msg.text) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


if name == ' main ': 
unittest.main() 





测试 执行 时 ，@data 将 调用 get_data() 方 法 去 读 
取 外 部 数据 文件 ， 并 将 数据 逐 行 返回 给 @data。 


8.3.2 ”通过 Excel 获 取 数 据 





用 Excel 来 维护 测试 数据 是 最 第 用 的 做 法 。 这 
还 可 以 帮助 非 技 术 人 员 很 轻松 地 洪 加 一 行 需要 的 测 
斌 数据。 结合 上 面 的 例子 ， 我 们 把 数据 整理 到 Excel 
中 ， 如 下 图 所 示 。 


—- — ü 
Category/Product €— 


phones 2 
music 5 
iphone 5s 0 





恋 取 Excel 文 件 ， 我 们 需要 用 到 另外 一 个 叫 xlrd 
的 库 ， 其 安装 命 AW. 


pip install xird 


xlrd 库 提供 了 读 取 工作 籍 、 工 作 表 以 及 单 
元 格 的 方法 。 如 条 需要 往 表 格 中 与 数 据 ， 则 
需要 用 到 xlwt 库 。 另 外 ，openpyxl 提 供 了 对 电 
子 表格 可 读 可 写 的 功能 











接 下 来 我 们 修改 get_data0 方 法 ， 试 着 从 外 部 的 
电子 表格 获取 测试 数据 ， 代 码 如 下 。 
import xlrd, unittest 


from ddt import ddt, data, unpack 
from selenium import webdriver 


def 


get_data(file_name): 

# create an empty list to store rows 

rows = [] 

# open the specified Excel spreadsheet as workbook 
book = xlrd.open workbook(file name) 

4 get the first sheet 

sheet = book.sheet by index(0) 

# iterate through the sheet and get data from rows 


in list 


eet 


for row idx in range(1, sheet.nrows): 
rows.append(list(sheet.row values(row idx, 0, sh 


.ncols))) 


return rows 


@ddt 
class SearchExcelDDT(unittest.TestCase): 


/") 


def setUp(self): 
# create a new Firefox session 
self.driver - webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 


# get the data from specified Excel spreadsheet 

# by calling the get data function 

Qdata(*get data("TestData.xlsx")) 

@unpack 

def test_search(self, search_value, expected_count) 


self.search_field = self.driver.find_element 


. by name("q") 


self.search field.clear() 


# enter search keyword and submit. 
self.search field.send keys(search value) 
self.search field.submit() 


# get all the anchor elements which have 

it product names displayed 

# currently on result page using 

it find elements by xpath method 

products = self.driver.find elements by xpat 


h 
("//h2[@class='product-name' |/a") 
if expected count > 9: 
# check count of products shown in resul 
ts 
self.assertEqual(expected count, len(pro 
ducts)) 


else: 
msg - self.driver. find element by class 
 name("note-msg") 
self.assertEqual("Your search returns no 
results.", msg.text) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


if | name == ' main ': 
unittest.main() 





类 似 读 取 CSV 文 件 一 样 ，@data 将 调用 
get_data0) 方 法 去 读 取 外 部 Excel 文 件 ， 并 将 数据 逐 
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通过 数据 库 获 取 数 据 





如 条 你 想 要 从 数据 库 的 库 表 中 获取 数 
据 ， 那 么 你 同样 需要 修改 get_data0) 方 法 ， 并 
且 通 过 DB 相关 的 库 来 连接 数据 库 、SQL 碍 询 
来 获取 测试 数据 。 





8.4 Page Object 设计 模式 











到 目前 为 止 ， 我 们 已 经 掌握 了 在 Python unittest 
单元 测试 框架 中 ， 编 写 Selenium WebDriver 测 试 脚 
本 的 方法 ， 并 且 可 以 在 测试 类 中 根据 测试 用 例 的 步 
又 使 用 合适 的 定位 器 。 然 后 ， 随 着 陆续 越 来 越 多 的 
测试 场景 加 入 目 动 化 测试 用 例 ， 那 么 与 之 对 应 的 测 
试 脚 本 吏 变 得 越 来 越 难以 维护 ， 甚 至 代码 变 得 很 脆 














开 及 可 维护 性 和 可 重用 的 测试 脚本 ， 对 于 持续 
目 动 化 测试 是 很 重要 的 。 其 重要 性 完全 不 亚 于 我 们 
被 测 产品 的 代码 标准 。 








如 何 去 解决 这 些 问题 呢 ? 如 末 你 是 一 个 开 友 工 
程 师 ， 你 可 能 会 调动 很 多 原则 和 方法 ， 诸 如 Don't 
Repeat Yourself (DRY， 高 级 码 农 的 信条 ， 不 做 重 
复 的 自己 ,不 写 重 复 的 代码 ) 或 定期 代码 重 构 的 方 





ik. Page Object 模式 ， 是 使 用 Selenium 的 广大 同行 
最 为 公认 的 一 种 设计 模式 。 在 设计 测试 时 ， 把 元 系 
和 方法 按照 页 面 抽象 出 来 ， 分 离 成 一 定 的 对 象 ， 然 
后 再 进行 组 织 。 它 相 较 之 前 的 Facade 模 式 ( 为 系统 
中 的 一 组 接口 所 提供 的 一 个 一 致 的 界面 ) 又 更 进 了 


一 一 
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Page Object 模式 ， 创 建 一 个 对 象 来 对 应 页 面 的 
一 个 应 用 。 因此， 我 们 可 以 为 每 个 页 面 定义 一 个 
类 ， 并 为 每 个 页 面 的 属性 和 操作 构建 模型 。 这 就 相 
当 于 在 测试 脚本 和 被 测 的 页 面 功能 中 分 离 出 一 层 ， 
屏蔽 了 定位 器 、 底 层 处 理 元 素 的 方法 和 业务 逻辑 ， 
取而代之 的 是 ，Page Object 会 提供 一 系列 的 API 来 
处 理 页 面 功能 。 




















测试 应 该 在 更 上 层 使 用 这 些 页 面 对 象 ， 在 撒 层 
页 面 中 的 属性 或 操作 的 任何 更 改 都 不 会 中 断 测试 。 
Page Object 模式 具有 以 下 几 个 优点 。 














。 抽象 出 对 象 可 以 最 大 程度 地 降低 开 及 人 员 修 改 
页 面 代码 对 测试 的 影响 ， 所 以 ， 你 仅 需 要 对 页 
面 对 象 进行 调整 ， 而 对 测试 没有 影响 ; 

。 可 以 在 多 个 测试 用 例 中 复 用 一 部 分 测试 代码 ; 

。 测 试 代 人 码 变 得 更 易 读 、 灵 活 、 可 维护 。 





接 下 来 ， 我 们 一 起 将 前 面 章节 已 经 实现 过 的 测 
试 脚本 进行 重 构 ， 对 原 应 用 程序 页 面 抽象 出 对 象 。 
在 这 个 示例 中 ， 我 们 将 针对 被 测 页 面 创建 如 下 图 所 
示 的 结构 。 首 先 我 们 要 实现 一 个 Base Page 对 象 

(可 以 理解 为 其 他 页 面 所 要 用 到 的 模板 〉， 对 应 的 
Base 对 象 提 供 了 其 他 页 面 需要 用 到 的 功能 区 块 。 例 
如 ， 上 所 有 的 页 面 都 用 到 搜索 功能 ， 那 么 我 们 可 以 基 
于 Base Page 创 建 一 个 Search 对 象 ， 接 下 来 我 们 分 别 
为 首页 、 搜 索 结 果 页 以 及 产品 页 面 各 自 创 建 类 。 
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8.4.1 测试 准备 


在 我 们 开始 用 Page Object 模式 设计 测试 之 前 ， 
首先 得 先 实现 一 个 名 为 BaseTestCase 的 类 ， 用 于 给 
我 们 提供 setUpO0 和 tearDownO 两 种 方法 ， 以 便 后 续 
我 们 写 每 个 类 都 可 以 拿 来 复 用 。 创 建 名 为 
basetestcase.py 的 脚本 ， 代 码 细节 如 下 。 


import unittest 
from selenium import webdriver 


class BaseTestCase(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get('http://demo.magentocommerce.com 


/') 


def tearDown(self): 
# close the browser window 
self.driver.quit() 





8.4.2 BasePageXJ 2: 


BasePage 对 象 相当 于 所 有 页 面 对 象 中 的 父 对 
象 ， 同 时 可 以 提供 公共 部 分 的 代码 。 创 建 名 为 
base.py 的 脚本 ， 代 码 细 和 如 下 。 








from abc import abstractmethod 
class BasePage(object): 


All page objects inherit from this """ 
def init (self, driver): 
self. validate page(driver) 


self.driver = driver 


@abstractmethod 


def validate page(self, driver): 
return 


" Regions define functionality available through 
all page objects """ 
@property 
def search(self): 
from search import SearchRegion 
return SearchRegion(self.driver) 


class InvalidPageException(Exception): 
" Throw this exception when you don't find the co 
rrect page """ 


pass 





我 们 增加 了 一 个 名 为 _validate_page() 的 抽象 方 
法 ， 继 承 BasePage 的 page 对 象 将 实现 这 个 方法 ， 目 
E E 
经 加 载 到 浏览 











另外 ， 我 们 还 创建 了 search 属 性 用 于 返回 
SearchRegion 对 象 。 类 似 于 一 个 页 面 对 象 ， 
SearchRegion 相 当 于 每 个 页 面 都 用 到 的 搜索 框 。 所 
以 接 下 来 其 他 页 面 对 象 都 可 以 共 孚 这 个 BasePage 


RR 





最 后 ， 我 们 也 实现 了 _validate_page0) 方 法 中 用 
到 的 InvalidPageException， 如 果 页 面 验 证 失败 ， 
InvalidPageException 将 会 被 抛 出 。 


8.4.3 ”实现 Page Object 


现在 ， 我 们 可 以 为 每 个 页 面 实现 Page Object 
Te 


(1) Ac, RIJE X HomePage, fi) 
homepage.py， 实 现 HomePage 类 ， 代 码 如 下 。 





from base import BasePage 
from base import InvalidPageException 


class HomePage(BasePage) : 


home page slideshow locator = 'div.slideshow-conta 
iner' 


def init (self, driver): 
super(HomePage, self). init (driver) 


def validate page(self, driver): 
try: 
driver.find element by class name (self. hom 
e page slideshow locator) 


except: 
raise InvalidPageException ("Home Page not 1 
oaded") 
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使 用 位 置 分 离开 。 我 们 可 以 创建 一 个 “” 前 级 的 私 
有 变量 ， 例 如 ， 用 _home_page_slideshow_locator 变 
量 来 保存 应 用 程序 首页 的 slideshow 组 件 的 定位 器 字 
符 串 。 我 们 可 以 利用 这 个 来 确认 浏览 左 是 人 否 正 负 加 
载 了 首页 。 








home page slideshow locator = 'div.slideshow-container' 


然后 ， 我 们 可 以 创建 _validate_page() 方 法 ， 通 
过 判断 Slideshow 元 素 是 否 已 经 显示 在 首页 上 了 ， 来 
判断 首页 是 否 被 加 载 。 














(2) 接 下 来 ， 我 们 实现 SearchRegion 类 ， 包 
括 searchFor0) 方 法 ， 访 方法 用 于 返回 SearchResults 类 
对 应 的 搜索 结果 页 面 。 创 建 一 个 新 的 脚本 
search.py， 并 且 实 现 这 两 个 类 ， 代 人 码 如 下 。 





from base import BasePage 
from base import InvalidPageException 
from product import ProductPage 


class SearchRegion(BasePage) : 


_search_box_locator = 'q 


def init (self, driver): 
super(SearchRegion, self). init (driver) 


def searchFor(self, term): 
self.search field = self.driver.find element by - 
name (self. search box locator) 
self.search field.clear() 
self.search field.send keys(term) 
self.search field.submit() 
return SearchResults(self.driver) 


class SearchResults(BasePage): 


product list locator = 'ul.products-grid > li' 
product name locator - 'h2.product-name a' 
product image link = 'a.product-image' 


page title locator 'div.page-title' 


| products count = 0 
| products = {} 


def init (self, driver): 

super(SearchResults, self). init (driver) 

results - self.driver.find elements by css selec 
tor (self. product list locator) 

for product in results: 

name - product.find element by css selector 

(self. product name locator).text 

self. products[name] = product.find element by c 


ss selector (self. product image link) 


def validate page(self, driver): 
if 'Search results for' not in driver.title: 
raise InvalidPageException ('Search results not 
loaded') 


@property 
def product_count(self): 
return len(self. products) 


def get_products(self): 
return self. products 


def open_product_page(self, product_name): 
self. products[product name].click() 
return ProductPage(self.driver) 





(3) 最 后 ， 我 们 要 实现 ProductPage 类 ， 这 个 
类 包括 了 很 多 有 关 商 品 的 一 些 必 性。 访问 一 个 商品 
的 详细 页 面 ， 可 以 通过 SearchResults 类 ， 打 开 搜 索 
结果 中 一 个 具体 的 产品 。 创 建 product.py 脚 本 文件 
实现 ProductPage 类 ， 代 码 如 下 。 





from base import BasePage 
from base import InvalidPageException 


class ProductPage(BasePage) : 
_product_view_locator = 'div.product-view' 
_product_name_locator = 'div.product-name 


span' 


| product description locator 'div.tab-content d 


iv.std' 

product stock status locator = 'p.availability sp 
an.value' 

| product price locator - 'span.price' 


def init (self, driver): 
super(ProductPage, self). init (driver) 


@property 
def name(self): 
return self.driver. \ 
find element by css selector 
(self. product name locator)N 
.text.strip() 


@property 
def description(self): 
return self.driver. \ 
find element by css selector 
(self. product description locator) 
.text.strip() 


@property 
def stock status(self): 
return self.driver. \ 
find element by css selector 
(self. product stock status locator)\ 
.text.strip() 


@property 
def price(self): 
return self.driver. \ 
find element by css selector 
(self. product price locator)" 


.text.strip() 


def validate page(self, driver): 
try: 
driver.find element by css selector (self. p 
roduct view locator) 
except: 
raise InvalidPageException ('Product page no 


t loaded') 





尔 还 可 以 进一步 添加 一 些 测试 场景 ， 例 如 在 丙 
中 击 商品 添加 到 购物 车 ， 或 者 比较 商品 ， 又 或 
者 通过 商品 属性 返回 相关 的 商品 。 


— 





8.4.4 构建 Page Object 模式 测试 实例 





结合 之 前 的 准备 ， 我 们 可 以 构建 完整 测试 了 。 
下 面 我 们 创建 一 个 用 于 检验 应 用 程序 搜索 功能 的 测 
试 ， 使 用 BaseTestCase 类 并 调用 我 们 之 前 创建 的 页 
面 对 象 。 该 测试 首先 创建 一 个 HomePage 实 例 ， 并 
调用 searchFor() 方 法 返回 SearchResults 实 例 。 然 后 调 
用 SearchResults 类 中 的 open_product_page() 方 法 ， 来 
打开 返回 的 搜索 结果 中 商品 的 详情 页 ， 进 而 检查 弄 


品 属性 。 


相关 脚本 searchtest.py， 以 及 其 中 
SearchProductTest 测 试 类 代码 如 下 。 


import unittest 
from homepage import HomePage 
from BaseTestCase import BaseTestCase 


class SearchProductTest(BaseTestCase): 
def testSearchForProduct(self): 
homepage - HomePage(self.driver) 
search results = homepage.search.searchFor('earp 
hones') 
self.assertEqual(2, search results.product count 


) 


product = search results.open product page ('MAD 
ISON EARBUDS') 
self.assertEqual('MADISON EARBUDS', product.name 


) 
self.assertEqual('$35.00', product.price) 


self.assertEqual('IN STOCK', product.stock statu 
s) 


if name == ' main ': 
unittest.main(verbosity-2) 





注意 ， 在 这 里 我 们 并 没有 写 setUpO 和 
tearDown() 两 个 方法 。 我 们 只 需要 继承 BaseTestCase 
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特殊 的 测试 场景 ， 当 然 也 可 以 重 载 这 两 个 方法 。 


通过 对 上 述 例子 完整 的 学 习 ， 我 们 已 经 掌握 了 
二 个 页 面 完 整 工作 流 的 Page Object 设计 测试 的 实 
践 。 你 也 可 以 通过 类 似 的 模式 对 如 购物 车 、 账 号 注 
册 、 登 录 等 场景 设计 测试 了 。 








8.5 ”章节 回顾 


本 章 我 们 认识 了 编写 数据 驱动 的 测试 方法 ， 以 
及 构建 可 复 用 、 易 量化 、 维 护 性 好 的 Page Object 模 
式 测试 脚本 。 其 中 数据 驱动 的 方法 ， 可 以 将 我 们 的 
测试 数据 与 测试 脚本 分 离开 来 ， 使 得 我 们 可 以 使 用 
更 复杂 有 的 测试 数据 ， 而 不 用 编写 新 的 测试 脚本 。 结 
合 unittest 和 ddt 库 ， 我 们 可 以 轻松 实现 多 种 外 部 数据 
源 的 测试 数据 获取 。 另 外 ， 关 于 如 何 用 Page Object 
模式 设计 测试 脚本 ， 以 及 如 何 对 一 个 简单 的 业务 场 
景 设 计 一 个 高 可 维护 性 的 测试 脚本 做 了 详细 的 介 


绍 。 














在 接 下 来 的 和 章节， 我 们 将 学 习 Selenium 
WebDriver API 的 一 些 高 级 特性 ， 例 如 第 用 的 截 
屏 、 屏 幕 录制 、 模 拟 鼠 标 与 键盘 操作 、 操 作 cookies 


VAY 
等 。 








第 9 章 Selenium WebDriver 的 
高 级 特性 





到 目前 为 止 ， 我 们 已 经 学 习 了 如 何 使 用 
Selenium WebDriver 来 测试 Web 应 用 ， 以 及 如 何 通 
过 WebDriver 中 的 一 些 主要 的 接口 与 页 面 元 素 进行 
ADE 


在 本 章 ， 我 们 将 进一步 探讨 WebDriver 中 的 一 
些 高 级 API， 当 测试 较 复 杂 的 应 用 场景 时 ， 这 些 功 
能 将 派 上 用 场 。 


本 章 包 合 以 下 主题 : 





。 通 过 Action 类 模拟 键盘 或 鼠标 事件 ; 
。 横 拟 一 些 鼠 标 操 作 ， 例 如 拖 搜 、 双 击 等 : 
。 ik] H JavaScript; 


。 截 屏 与 录制 ， 
e Jt cookies; 
。 DEL BUE TE. 


9.1 HAE iin Se 


WebDriver 高 级 应 用 的 API， 人 允许 我 们 模拟 简单 
的 键盘 和 鼠标 事件 ， 如 拖 搜 操作 、 人 快捷 键 组 

、 长 按 以 及 鼠标 右键 操作 。 这 些 都 是 通过 使 用 
WebDriver 的 Python API 中 ActionChains 类 实现 的 。 


下 表 列 出 ActionChains 类 中 一 些 关 于 键盘 和 上 鼠 
标 事件 的 重要 方法 。 























on_element: 


指 被 单 击 的 元 


























click(on_element=None) S 素 。 如 果 该 参 click(main_link) 












































on_element: 


指 被 单 击 且 按 
对 元 素 | 住 鼠 标 左 键 的 





click_and_hold(on_element=None) | 按 住 鼠 元 素 。 如 果 该 click_and_hold(gmail_link) 





double_click(on_element=None) 


drag_and_drop(source, target) 


key_down(value, element=None) 


标 左 键 











鼠标 拖 
动 




















None， 将 单 
击 当 前 鼠标 位 
置 





on_element: 


指 被 双击 的 元 
素 。 如 果 该 参 
数 为 None， 

将 双击 当前 鼠 
标 位 置 


























source: 


鼠标 拖 动 的 源 
元 素 。 


target: 








鼠标 释放 的 
标 元 素 

















key: 指 修饰 
键 。Key 的 值 
在 Keys 类 中 定 
Xs 


target: 按键 

触发 的 目标 元 
素 ， 如 果 为 

None， 则 按 

键 在 当前 鼠标 
聚焦 的 元 素 上 
触发 








double_click(info_box) 


drag_and_drop(img, canvas) 


key_down(Keys. SHIFT)\ 


key_up(value, element=None) 


move_to_element(to_element) 


perform() 


release(on_element=None) 


send_keys(keys_to_send) 





HFR 
ieii 
键 

















素 的 键 


send_keys(‘n’)\ 

key_up(Keys.SHIFT) 
key: 指 修饰 
键 。Key 的 值 
在 Keys 类 中 定 
义 。 











target: 按键 
触发 的 目标 元 
素 ， 如 果 为 
None， 则 按 
键 在 当前 鼠标 
聚焦 的 元 素 上 
触发 





to_element: 
move_to_element(gmail_link) 


指定 的 元 素 


perform() 


on_element: 


被 鼠标 释放 的 release(banner_img) 





元 素 


keys_to_send: 
send keys(^hello") 
键盘 的 输入 值 





盘 操 作 


element: 


指定 的 元 素 。 


send_keys_to_element(firstName, 


send_keys_to_element(element, 





keys_to_send) “John”) 


keys_to_send: 


键盘 的 输入 值 





获取 更 多 细 市 可 访问 
http://selenium.googlecode.com/git/docs/api/py/webdrh 


webdriver.common.action chains.html. 


gi | 
S5] 
A | 


Interactions API H Bj ^ x FF Safari w, 
aes EEREN sss Et — XE AY Ja ER. 
性 。 更 多 详情 请 访问 
https://code.google.com/p/selenium/ 











wiki/AdvancedUserlInteractions o 





9.1.1 键盘 事件 


接 下 来 我 们 创建 一 个 测试 脚本 ， 用 来 模拟 一 个 
组 合 键 的 操作 。 在 这 个 简单 的 场景 中 ， 当 我 们 按 下 
Shift+N 组 合 键 时 ，label 标 签 会 改变 颜色 。 代 人 码 如 
Bo 











from selenium import webdriver 
from selenium.webdriver.common.by import By 
from selenium.webdriver.support.ui import WebDriverWait 


from selenium.webdriver.support import expected_conditi 
ons 

from selenium.webdriver.common.action_chains import Act 
ionChains 

from selenium.webdriver.common.keys import Keys 

import unittest 


class HotkeyTest(unittest.TestCase): 
URL = "https://rawgit.com/jeresig/jquery.hotkeys/ma 
ster/test-static-05.html" 


def setUp(self): 
self.driver = webdriver.Chrome() 
self.driver.get(self.URL) 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


def test hotkey(self): 
driver = self.driver 


shift n label = WebDriverWait(self.driver, 10).\ 


until(expected conditions.visibility of elem 
ent 


located((By.ID, " shift n"))) 


ActionChains(driver).\ 
key_down(Keys.SHIFT).\ 
send_keys('n').\ 
key_up(Keys.SHIFT).perform() 
self .assertEqual("rgba(12, 162, 255, 1)", 
shift_n_label.value_of_css_ 
property("background-color")) 


def tearDown(self): 
self.driver.close() 


if _ name == "_ main __ 
unittest.main(verbosity-2) 





过 使 用 ActionChains 类 ， 我 们 可 以 实现 组 合 
ER RI E wn 


send key()5key. up) — T Zr ik iU. HA BRE Shift+N 
组 合 键 。 


ActionChains(driver).\ 
key_down(Keys.SHIFT).\ 


send_keys('n').\ 
key_up(Keys.SHIFT).perform() 





当 调 用 ActionChains 类 的 方法 时 ， 它 不 会 立即 


执行 ， 而 是 会 将 所 有 的 操作 按 顺 序 存 放 在 一 个 队列 
里 ， 当 调用 perform() 方 法 时 ， 队 列 中 的 事件 会 依次 
执行 。 
9.1.2 ”鼠标 事件 

下 面 演示 一 个 调用 ActionChains 类 中 的 
move_to_element() 方 法 实现 鼠标 移动 的 示例 。 这 个 


方法 类 似 于 onMouseOver 事 件 。move_to_element() 
方法 是 将 光标 从 当前 位 置 移动 到 指定 的 元 素 。 








from selenium import webdriver 
from selenium.webdriver.common.by import By 
from selenium.webdriver.support.ui import WebDriverWait 


from selenium.webdriver.support import expected_conditi 
ons 

from selenium.webdriver.common.action_chains import Act 
ionChains 

import unittest 


class ToolTipTest (unittest.TestCase): 
def setUp(self): 
self.driver - webdriver.Firefox() 
self.driver.get("http://jqueryui.com/tooltip/") 
self.driver.implicitly wait(30) 


self.driver.maximize window() 


def test tool tip(self): 
driver = self.driver 


frame elm = driver.find element by class name("d 
emo- frame") 
driver.switch to.frame(frame elm) 


age field = driver.find element by id("age") 
ActionChains(self.driver).move to element(age fi 
eld).perform() 


tool tip elm = WebDriverWait(self.driver, 10)\ 
.until(expected conditions.visibility of ele 
ment 
located((By.CLASS NAME, "ui-tooltip-content" 


))) 


# verify tooltip message 

self .assertEqual("We ask for your age only for s 
tatistical 

purposes.", tool tip elm.text) 


def tearDown(self): 
self.driver.close() 


if name == " main ": 
unittest.main(verbosity-2) 





9.1.2.1 ”双击 操作 


调用 ActionChains 类 中 的 double_click0) 方 法 实 
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from selenium import webdriver 


from selenium.webdriver.common.action_chains import Act 
ionChains 
import unittest 


class DoubleClickTest (unittest.TestCase): 
URL = "http://api.jquery.com/dblclick/" 


def setUp(self): 
self.driver = webdriver.Chrome() 
self .driver.get(self.URL) 
self.driver.maximize window() 


def test double click(self): 
driver - self.driver 
frame - driver.find element by tag name("iframe" 


driver.switch to.frame(frame) 
box = driver.find element by tag name("div") 


# verify color is Blue 
self.assertEqual("rgba(0, 0, 255, 1)", 
box.value of css property("back 
ground-color")) 


ActionChains(driver).move to element 
( driver.find element by tag name("span"))\.p 


erform() 


ActionChains(driver).double click(box).perform() 


# verify Color is Yellow 
self.assertEqual("rgba(255, 255, 0, 1)", 


box.value_of_css_property("backg 
round-color")) 


def tearDown(self): 
self.driver.close() 


if name == " main ": 
unittest.main(verbosity-2) 





9.1.2.2. ”鼠标 拖 动 


调用 ActionChains 类 中 的 drag_and_drop0 方 法 实 
现 鼠 标的 拖 放 操作 。 这 个 方法 拖 动产 元 系 ， 然 后 在 
目标 元 系 的 位 置 释 放 源 元 素 。 示 例如 下 。 














from selenium import webdriver 


from selenium.webdriver.common.action_chains import Act 
ionChains 


import unittest 


class DragAndDropTest (unittest.TestCase): 


URL = "http://jqueryui.com/resources/ 
demos/droppable/default.html" 


def setUp(self): 
self.driver = webdriver.Firefox() 
self.driver.get(self.URL) 


self.driver.maximize window(30) 
self.driver.maximize window() 


def test drag and drop(self): 
driver - self.driver 


driver.find element by id("draggable") 
driver.find element by id("droppable") 


source 
target 


ActionChains(self.driver).drag and drop(source, 


target). perform() 
self.assertEqual("Dropped!", target.text) 


def tearDown(self): 
self.driver.close() 


if name == " main ^": 
unittest.main(verbosity-2) 





9.2 iH JavaScript 


在 执行 某 些 特殊 操作 或 测试 JavaScript 代 码 时 ， 
WebDriver 还 提供 了 调用 JavaScript 的 方法 。 
WebDriver 类 包含 的 相关 方法 见 下 表 。 























异步 执 |script: 被 执行 的 JS 
行 JS 代 | 代码。 args:JS 代 码 
中 的 任意 参数 


execute_async_script(script, 


driver.execute_async_script("return 


*args) document.title") 





script: 被 执行 的 JS 
a 代码。 args:JS 代 码 
中 的 任意 参数 


execute script(script, driver.execute script("return 
*args) document.title") 











接 下 来 创建 的 测试 用 到 了 工具 方法 ， 该 工具 方 
法 在 使 用 JavaScript 方 法 对 元 素 执 行 操作 之 前 ， 先 对 


它们 进行 高 有 党 显示 。 


from selenium import webdriver 
import unittest 





class ExecuteJavaScriptTest (unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver - webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 


/") 
def test_search_by_category(self): 


# get the search textbox 

search field = self.driver.find_element_by_name( 
"q") 

self.highlightElement(search field) 

search_field.clear() 


# enter search keyword and submit 
self.highlightElement(search field) 
search field.send keys("phones") 
search field.submit() 


# get all the anchor elements which have product 
names 

# displayed currently on result page using 

it find elements by xpath method 

products - self.driver.find elements by xpath("/ 
/h2[@ class-'product-name']/a") 


# check count of products shown in results 
self.assertEqual(2, len(products)) 


def tearDown(self): 
# close the browser window 
self.driver.quit() 


def highlightElement(self, element): 

self.driver.execute script("arguments[0].setAttr 
ibute('style', 

arguments[1]);", 

element, "color: green; 

border: 2px solid green;") 

self.driver.execute script("arguments[0].setAttr 
ibute('style', 

arguments[1]);", 

element , "") 


if | name == " main _ 
unittest.main(verbosity-2) 





我 们 可 以 通过 调用 WebDriver 类 的 
execute_script 方 法 来 执行 JavaScript 人 代码， 也 可 以 通 
过 这 个 方法 传递 参数 给 JavaScript 代 码 ， 示 例 代 码 如 
下 。 在 这 个 例子 中 ， 我 们 修改 了 边框 样式 ， 然 后 又 
立即 恢复 到 原来 的 样子 。 在 执行 期 间 ， 元 素 将 以 绿 
色 边 框 高 完 旺 示 ， 这 对 于 了 解 哪 一 个 步骤 正在 执行 
是 非常 有 用 的 。 








def highlightElement(self, element): 
self.driver.execute script("arguments[0].setAttrib 


ute('style', 
arguments[1]);", 
element, "color: green; border: 2px solid green;") 
self.driver.execute script("arguments[0].setAttrib 
ute('style', 
arguments[1]);", 
element , "") 





9.3 HERR 
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WebDriver 内 置 了 一 些 在 测试 执行 过 程 中 捕获 屏幕 
并 保存 的 方法 ， 如 下 表 所 示 。 





Save_ Screenshot(filename) 


get_screenshot_as_base64() 














幕 截图 并 保 
存 为 指定 文 



































base64 编 码 
字符 串 (用 
于 HTML 页 
HARRA 
base64 编 码 
ET) 




















获取 当前 的 
使 用 完整 的 
路 径 。 如 果 














filename: 
指定 保存 
的 路 径 / 图 








片 文件 名 





filename: 


指定 保存 





Driver.save_ screenshot 


("homepage.png") 


driver.get screenshot as base64() 


driver.get 











get_screenshot_as_file(filename) | 有 任何 的 路 径 / 图 | screenshot_as_file('/results/ 
IOError， 返 | 片 文件 名 | screenshots/ HomePage.png") 
l=|False, 15 


则 返回 True 























获取 当前 屏 
幕 截图 的 二 








get_screenshot_as_png() driver.get_screenshot_as_png() 


进 制 文 件数 
据 








接 下 来 ， 我 们 通过 屏 舌 截图 来 捕获 一 个 测试 执 
行 出 错 的 场景 。 场 景 中 ， 我 们 定位 一 个 本 来 应 该 显 
示 在 主页 的 元 素 。 如 采 测 试 脚本 没有 发 现 对 应 元 
素 ， 则 立即 抛 出 NoSuchElement Exception: i» [rij] 
时 截取 当前 浏览 右 窗 口 截 图 ， 我 们 可 以 把 它 作为 
bug 的 依据 发 给 开发 人 员 定 位 问题 。 











from selenium import webdriver 

import datetime, time, unittest 

from selenium.common.exceptions import NoSuchElementExc 
eption 


class ScreenShotTest(unittest.TestCase): 
def setUp(self): 
self.driver - webdriver.Firefox() 
self.driver.get("http://demo.magentocommerce.com 


/") 


def test screen shot(self): 
driver - self.driver 
try: 
promo banner elem - driver.find element by i 
d("promo banner") 
self.assertEqual("Promotions", promo banner 
elem.text) 
except NoSuchElementException: 
st = datetime.datetime\ 
.fromtimestamp(time.time()).strftime('%Y 
%m%d_%H%M%S ' ) 
file name = "main page missing banner" + st 


driver.save screenshot(file name) 
raise 


def tearDown(self): 
self.driver.close() 


if name == " main ": 
unittest.main(verbosity-2) 





在 上 述 代码 中 ， 当 测试 脚本 找 不 
到 ]“promo_banner” 元 素 时 ， 程 序 就 调用 
save_screenshot() 方 法 来 目 动 截屏 ， 并 以 我 们 定义 的 
图 片 文件 名 保存 在 指定 的 路 径 下 。 














try: 
promo banner elem = driver.find element by id("prom 


o banner") 

self.assertEqual("Promotions", promo banner elem.te 
xt) 
except NoSuchElementException: 

st = datetime.datetime.fromtimestamp(time.time()). 
strftime( '%Y%m%d_%H%M%S ' ) 

file name = "main page missing banner" + st + ".png 


driver.save screenshot(file name) 
raise 
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当 我 们 使 用 上 述 截屏 方法 时 ， 推 荐 使 用 
包含 唯一 标识 《例如 时 间 惟 ) 的 名 称 ， 并 且 
保存 为 PNG 图 片 等 高 压缩 图 片 格式 ， 来 控制 
图 片 的 大 小 。 





9.4 Bist 
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为 提交 问题 时 的 依据 发 送 给 项 目 相 关 人 员 ， 也 可 以 
作为 产品 的 功能 演示 。 





然而 ，Selenium WebDriver 没 有 内 置 录制 的 功 
能 ， 所 以 要 依赖 Python 类 库 中 名 为 Castro 的 工具 。 
是 由 Selenium 创 始 人 Jason Huggin 设 计 的 。Castro 
caren Edel] LE Pyvnc2switt KA © 
使 用 VNC 协 议 录 制 屏 硕 并 生成 SWF 视 频 文 件 。 


由 于 符合 VNC 协 议 ， 所 以 我 们 还 可 以 实现 对 远 
程 机 器 《了 预 装 VNC 相 关 程 序 包 ) WSEAS. FEZ 
装 PyGame， 然 后 安装 Castro，pip 命 令 如 下 。 


pip install Castro 


如 果 Server 和 Viewer 端 都 是 Windows 的 环境 ， 
我 们 可 以 选择 安装 TightVNC 工 具 。 


如 采 在 Ubuntu 操作 系统 上 ， 可 以 依次 操 
作 Settings | Preference | Remote Desktop， 人 然后 选 
"F Allow other users to view your desktop 复 选 框 。 
在 Mac 上 ， 我 们 可 以 安装 Vine VNC Server 或 者 
在 System Preferences 中 打开 Remote Desktop. 








结合 之 前 章节 我 们 设计 过 的 测试 脚本 ,添加 屏 
幕 录制 功能 ， 代 人 码 如 下 。 





import unittest 
from selenium import webdriver 
from castro import Castro 


class SearchProductTest(unittest.TestCase): 
def setUp(self): 
# create an instance of Castro and provide name 
for the output 
# file 
self.screenCapture = Castro(filename="testSearch 
ByCategory. swf") 
# start the recording of movie 
self.screenCapture.start() 


/") 


def 


"q^) 


names 


# create a new Firefox session 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 
test search by category(self): 


# get the search textbox 
search field = self.driver.find element by name( 


search field.clear() 

# enter search keyword and submit 
search field.send keys("phones") 
search field.submit() 


# get all the anchor elements which have product 


# displayed 
# currently on result page using find elements b 


y xpath method 


/h2[@ 


products = self.driver.find elements by xpath("/ 
class-'product-name']/a") 


# check count of products shown in results 
self.assertEqual(2, len(products)) 


def tearDown(self): 


# close the browser window 
self.driver.quit() 
# Stop the recording 


self.screenCapture.stop() 


if | name == ' main 


unittest.main(verbosity=2) 
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话 ， 我 们 需要 创建 一 个 Castro 对 象 并 且 使 用 录像 文 
件 的 路 径 和 名 称 作为 参数 初始 化 实例 。start0 和 
stop(0) 方 法 用 于 控制 屏幕 录制 的 起 止 位 。 人 代码 中 
setUp(0) 方 法 的 部 分 就 是 一 个 最 佳 的 初始 化 Castro 实 
例 ， 并 且 是 开始 录制 的 示例 。 





def setUp(self): 
# Create an instance of Castro and provide name for 
the output 
# file 
self.screenCapture = Castro(filename="testSearchByC 
ategory.swf") 
# Start the recording of movie 
self.screenCapture.start() 


# create a new Firefox session 
self.driver - webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com/") 











在 teadDown0 部 分 ， 我 们 可 以 看 到 当 完 整 的 测 
试用 例 都 执行 完成 后 ， 调 用 stop0O 方 法 来 停止 屏 舌 
录制 。 代 码 如 下 。 


def tearDown(self): 
# close the browser window 


self .driver.quit() 
# Stop the recording 
self.screenCapture.stop() 








特别 是 在 组 合 多 个 测试 场景 的 测试 类 中 ， 我 们 
同样 也 可 用 上 述 setUp0O 和 tearDown0 方 法 ， 来 实现 
整个 测试 类 的 屏 妖 录制 操作 的 开局 与 俘 止 ， 无 须 对 
不 同 测试 场景 重复 单独 构建 。 








9.5 弹出 窗 的 处 理 


弹出 窗 的 处 理 过 程 包括 : 通过 弹出 窗 的 名 称 或 
句柄 来 定位 ， 切 换 Driver Context 至 所 需 的 弹出 窗 ， 
在 弹出 窗 上 执行 相关 操作 步 又 ， 最 后 跳 转 回 到 上 级 
窗口 CORB. 











结合 我 们 的 测试 ， 创 建 一 个 基于 浏览 器 的 实 
例 ， 基 于 父 窗口 随后 弹出 新 的 窗口 ， 我 们 统称 为 子 
窗口 或 弹出 窗 。 只 要 该 弹出 窗 属于 当前 WebDriver 


Context， 我 们 都 可 以 对 它 进 行 操 作 。 





下 图 展示 一 个 弹出 窗 的 例子 。 


H1 Apps Selenium 站] Agile Symantec Testing Apple/iOS Web MB! SampleVBScripts«.. (9 Disco 


Configure Your Details Payment 





[L file///C/Users/UNMESH/Dropbox/Public/OnlineChat.html 


Configu 
Build my Car - Configuration - Online Chat 
Select Make: 
Petrol Wait while we connect you to Chat... 


Select Optionay close 


Select Colors 
Black 


创建 一 个 新 的 测试 类 PopupWindowTest， 其 中 
包括 test popup _window() 方 法 ， 代 码 如 下 。 





from selenium import webdriver 
import unittest 


class PopupWindowTest(unittest.TestCase): 


URL = "https://rawgit.com/upgundecha/learnsewithpyt 
hon/master/pages/Config.html" 


def setUp(self) 
self.driver - webdriver.Firefox() 
self.driver.get(self.URL) 
self.driver.maximize window() 


def test popup window(self): 
driver - self.driver 


# save the WindowHandle of Parent Browser Window 
parent window id = driver.current window handle 


# clicking Help Button will open Help Page in a 
new Popup 

# Browser Window 

help button - driver.find element by id("helpbut 
ton") 

help button.click() 

driver.switch to.window("HelpWindow") 

driver.close() 

driver.switch to.window(parent window id) 


def tearDown(self): 
self.driver.close() 


if | name  -- " main _ 
unittest.main(verbosity-2) 











在 Context 调 用 弹出 窗口 显示 之 前 ， 我 们 先 通 过 
current_window_handle 属 性 将 父 窗口 的 句柄 信息 保 
存 下 来 〈“ 稍 后 我 们 将 使 用 这 个 信息 从 弹出 窗 返 回 到 
父 窗口 ) 。 接 大 使 用 WebDriver 下 的 
switch_to.window() 方 法 获取 弹出 寄 的 名 称 或 句柄 信 
轧 ， 切 换 到 我 们 要 操作 的 那个 弹出 窗 〈 子 窗口 ) 








下 面 我 们 演示 通过 名 称 定 位 弹出 窗 。 


我 们 操作 完 Help 窗 口 之 后 ， 通 过 close() 方 法 关 
闭 窗口 ， 并 且 返 回 至 父 窗口 ， 代 人 码 如 下 。 








driver.close() 


# switch back to Home page window using the handle 
driver.switch to window(default window) 





9.6 ”操作 cookies 


为 了 更 好 的 用 户 体 验 ，cookies 作 为 Web 应 用 一 
项 很 重要 的 手段 ， 将 一 些 诸如 用 户 偏 好、 登录 信 息 
以 及 各 种 客户 端 细节 信息 ， 记 录 并 保存 在 用 户 计 算 
机 本 地 。WebDriver 提 供 了 一 组 操作 cookies 的 方 
法 ， 包 括 读 取 、 添 加 和 删除 cookies 人 信息。 这些 方 法 
可 以 帮助 我 们 操作 cookies， 来 校 验 Web 应 用 程序 对 
应 的 啊 应 。 上 其 体 方法 见 下 表 。 





























cookie dict: Jtt 
对 象 ， 包 含 name 
与 value 值 


在 当前 会 话 中 添加 


cookie(cookie dict) | cookie 信 息 


driver.add_ 
cookie({"foo","bar"}) 





删除 单个 名 为 name 的 
delete_cookie(name) " 
cookief = 


在 当前 会 话 中 删除 所 有 
delete_all_cookies() m 
cookie 信 息 


返回 单个 名 为 name 的 


name: 要 删除 的 
cookie 的 名 称 


driver.delete cookie("foo") 





driver.delete all cookies() 


name: 要 查找 的 








get_cookie(name) “| cookie 信 息 。 如 果 没 有 |cookie 的 名 称 driver.get_ cookie("foo") 


找到 ， 返 回 none 














返回 当前 会 话 所 有 的 


cookie 信 息 








driver.get_cookies() 


get_cookies() 





接 下 的 例子 ， 我 们 来 验证 用 户 在 首页 选择 语言 
后 ， 是 否 被 正确 保存 到 cookie 中 。 





import unittest 
from selenium import webdriver 
from selenium.webdriver.support.ui import Select 


class CookiesTest(unittest.TestCase): 
def setUp(self): 
# create a new Firefox session 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait(30) 
self.driver.maximize window() 


# navigate to the application home page 
self.driver.get("http://demo.magentocommerce.com 


"AD 


def test store cookie(self): 
driver - self.driver 
# get the Your language dropdown as instance of 


Select class 
select language = \ 
Select(self.driver.find element by id("selec 


t-language")) 


# check default selected option is English 

self.assertEqual("ENGLISH", select_language.firs 
t_selected_ option.text) 

# store cookies should be none 

store cookie = driver.get cookie("store") 

self.assertEqual(None, store cookie) 


# select an option using select by visible text 
select language.select by visible text("French") 


# store cookie should be populated with selected 
country 
store cookie = driver.get cookie("store")['value 


d 
self.assertEqual("french", store cookie) 
def tearDown(self): 
# close the browser window 
self.driver.quit() 
if | name == ' main ': 


unittest.main(verbosity-2) 





上 述 代 人 码 中 ， 我 们 传递 一 个 cookie 的 名 称 ， 就 
可 以 通过 get_cookie0) 方 法 获取 到 对 应 cookie 的 值 。 





9.7 章节 回顾 


在 本 章 ， 我 们 学 习 了 一 些 关 于 Selenium 
WebDriver 的 高 级 特性 ， 例 如 键盘 和 鼠标 事件 、 截 
Be. CE 录制 以 及 操作 cookies。 








用 ActionChains 类 模拟 各 种 键 认 和 鼠标 的 操 
作 ， 这 在 处 理 大 量 使 用 键盘 和 鼠标 操作 的 应 用 程序 
时 非常 有 用 。 


从 测试 中 ， 你 已 经 看 到 了 如 何 运 行 JavaScript 代 
码 。 这 是 一 个 非常 强大 的 功能 特性 ， 让 我 们 能 够 轻 
松 应 对 Ajax 应 用 ， 能 够 在 测试 脚本 中 调用 撒 层 的 
JavaScipt API. 





当 测 试 过 程 中 产生 错误 (有 可 能 是 测试 脚本 的 
问题 ， 也 有 可 能 是 产品 的 bug〉 时 ， 目 动 截屏 或 是 
屏幕 录制 ， 都 能 极 大 地 帮助 我 们 调试 测试 脚本 以 及 








作为 提交 bug 的 重要 依据 。 
最 后 部 分 ， 我 们 还 学 习 了 操作 浏览 器 窗口 与 
cookies 的 方法 。 


在 下 一 章 市 ， 我 们 将 学 习 如 何 将 自动 化 测试 与 
其 他 持续 集成 的 工具 进行 联动 与 整合 。 





第 10 章 ”第 三 方 工具 与 框架 集 
成 





Selenium WebDriver Python API 是 非常 强大 和 
灵活 的 。 到 目前 为 止 ， 我 们 已 经 学 习 了 如 何 通 过 
Selenium WebDriver 集 成 unittest 类 库 来 搭建 一 个 简 
单 的 自动 化 测 斌 框架。 然而， 除了 unittest 之 外， 
Selenium WebDriver 还 可 以 集成 很 多 其 他 的 工具 和 
框架 。 目 前 已 经 有 很 多 基于 Selenium WebDriver SZ 
现 的 框架 了 。 





我 们 可 以 通过 使 Selenium WebDriver 与 现 有 的 
支持 BDD 行为 驱动 开发 ) 的 框架 结合 起 来 ， 在 日 
动 化 测试 项 目 中 实现 BDD。 








还 可 以 将 Selenium Python API 与 持续 集成 
(CD 工具 、 构 建 工 具 相 集成 ， 一 旦 应 用 程序 开发 


完成 就 可 以 立即 执行 测试 。 这 可 以 使 开发 人 员 对 应 
用 程序 的 质量 和 稳定 性 得 到 更 早 的 反馈 。 


本 章 包 含 以 下 一 些 主要 集成 的 实例 : 


e 下 载 和 安装 Behave; 

e 使 用 Behave 编 写 feature; 

。 使 用 Behave 和 Selenium WebDriver 上 自动 化 验证 
feature; 

e 下载 和 安装 Jenkins:; 

e 4%! Jenkinsiz 1] Seleniumillll ix; 

e. Ac S Jenkins fi $2 MAR o 


10.1 行为 驱动 开 友 (BDD) 


BDD 是 Dan North 在 他 的 论文 《Introducing 
BDD》 中 提出 的 一 种 敏捷 软件 开发 方法 。 


BDD 也 称 为 验收 测试 驱动 开发 ATDD) 、 基 
于 用 户 故 事 敏 捷 测试 (story testing) 或 实例 化 需求 
(specification by example) 。BDD 或 励 软件 项 目 中 
的 开发 者 、QA 和 非 技 术 人 员 或 商业 参与 者 之 间 的 
协作 ， 一 起 定义 项 目 规 范 ， 决 定 验 收 标 准 ， 用 目 然 
语言 书写 出 非 程 序 员 可 读 的 测试 用 例 。 











Python 中 有 很 多 工具 都 可 以 实现 BDD， 
其 中 两 个 主要 的 工具 是 Behave 和 Lettuce。 





Lettuce 是 受到 了 著名 的 Ruby BDD 
Cucumber 启 发 。 





在 接 下 来 的 章节 中 ， 你 将 学 习 到 怎样 使 用 
Behave 来 为 示例 应 用 程序 实现 BDD。 


10.1.1 Behave Z% 


安装 Behave 的 过 程 很 简单 ， 通 过 以 下 命令 可 直 
接 下 载 和 安装 Behave。 


pip install behave 


t 才 程 中 ， 会 下 载 并 安装 Behave 和 
它 依 赖 的 第 三 


10.1.2 ”第 一 个 feature 


在 Behave 中 编写 第 一 个 feature 的 过 程 从 讨论 和 
列举 开发 中 的 应 用 程序 的 feature 和 User Story 开 始 。 
各 利益 相关 者 聚 在 一 起 ， 有 开 及 者 、 测 斌 人员、 和 需 
求 分 析 师 和 客户 ， 使 用 各 参与 者 都 能 理解 的 通用 语 
言 创 建 feature、User Story 和 验收 标准 的 列表 。 





Behave xz 4/4 Given-When-Then (GWT) 格式 的 
Gherkin 语 言 创 建 feature 文 件 。 


让 我 们 从 示例 应 用 程序 中 的 搜索 功能 的 feature 
开始 。 访 搜索 feature 是 让 用 户 从 主页 搜索 产品 。 
feature 文 件 以 GWT 格 式 对 User Story 和 验收 标准 进 
47 fe] PFI , € (Scenario 
Outline) ， 也 称 为 场景 步骤 (Scenario Steps) , ff 
释 如 下 。 





Given: 设置 一 个 场景 执行 的 前 提 条 件 ， 本 例 中 








一 一 导航 到 主页 。 
e When: 包含 一 个 场景 所 要 执行 的 操作 ， 本 例 中 
一 一 搜索 茶 件 产品 。 





Then: 包含 一 个 场景 执行 后 的 结果 ， 本 例 中 
一 一 检查 所 有 匹配 的 产品 列表 能 否 正 党 显示 。 


一 个 场景 中 可 以 有 多 个 When 和 Then。 


Feature: I want to search for products 


Scenario Outline: Search 

Given I am on home page 

when I search for "phone" 

then I should see list of matching products in sear 
ch results 





我 们 需要 将 它 保 存 为 扩展 名 为 "feature” 的 纯 文 
本 文件 才能 在 Behave 中 使 用 。 现 在 新 建 一 个 
bdd/feature LFX, Ja Y feature LEM Z 
为 “search.feature”， 保 存在 该 文件 夹 下 。 


10.1.2.1 step 定义 





feature 文 件 完成 后 ， 我 们 需要 为 feature 文 件 的 
场景 大 纲 中 的 step 分 别 进行 定义 。 一 个 step 定 义 就 是 
一 个 Python 代 码 块 ， 代 码 块 用 人 简单 明了 的 文字 命 
名 ， 代 人 码 调用 Python API 或 者 Selenium WebDriver 命 
令 来 执行 该 step 的 内 容 。step 定 义 文件 须 保存 在 
feature 文 件 所 在 路 径 的 子 目录 “steps” 下 。 下 面 束 创 

建 一 个 search_steps.py 文 件 来 定义 上 面 feature 文 件 中 














的 step。 


from behave import * 


@given('I am on home page') 
def step i am on home page(context): 
context.driver.get("http://demo.magentocommerce.com 


/") 


@when('I search for {text}') 
def step i search for(context, text): 

search field = context.driver.find element by name( 
"q") 

search field.clear() 


# enter search keyword and submit 
search field.send keys(text) 
search field.submit() 


@then('I should see list of matching products in search 
results') 

def step i should see list(context): 

products = context.driver. \ 

find_elements_by_xpath("//h2[@class='product-nam 

e']/a") 

# check count of products shown in results 

assert len(products) > @ 





对 于 每 个 GWT， 我 们 都 需要 创建 一 个 匹配 的 
step 定 义 。 下 面 的 代码 是 为 Given 中 的 “I am on home 
page” 创 建 的 step 定 义 。 使 用 @ 修 饰 符 和 feature 文 件 


中 给 出 的 GWT 来 标识 对 应 的 step， 如 @given， 
@when，@then， 并 且 接 收 一 个 字符 串 ， oe 
包含 对 应 场景 step 中 剩余 部 分 的 步骤 描述 信息 ， 如 
本 例 中 的 “Iam on home page". 








@given('I am on home page') 
def step i am on home page(context): 


context.driver.get("http://demo.magentocommerce.com 


/") 








我 们 也 可 以 将 step 中 内 髓 的 参数 传 圳 给 step 定 
义 。 例 如 ， 在 @when 中 我 们 这 么 写 上 面 的 搜索 语 
^]: when I search for“phone”。 然 后 在 step 定 义 中 通 
过 {text} 来 读 取 这 个 “phone” 值 ， 如 下 代码 所 示 。 


@when('I search for {text}') 
def step i search for(context, text): 
search field = context.driver.find element by name( 


"q^) 


search field.clear() 


# enter search keyword and submit 
search field.send keys(text) 
search field.submit() 





M E TR AB Ft A] DA SUPE eZ stepe XW E 
下 文 变量 。Behave 通 过 这 个 上 下 文 变量 来 存储 要 共 
享 的 信息 。 它 运行 在 3 个 层面 ， 由 Behave 上 自动 管 
理 。 我 们 还 可 以 使 用 上 下 文 变量 来 存储 和 共享 step 
之 间 的 信息 。 





10.1.2.2 ”环境 配置 





在 运行 feature 之 前 ， 需 要 创建 一 个 环境 配置 文 
件 ， 用 于 配置 Behave 的 第 用 设置 ， 以 及 step 之 间或 
step 定 义 文 件 之 间 的 共享 代码 。 如 果 用 Selenium 
WebDriver 和 Firefox 浏 览 器 执行 测试 步骤 的 话 ， 这 
个 文件 可 以 在 启动 Firefox 时 初始 化 WebDriver。 下 
面 我 们 在 feature 文 件 目录 中 新 建 一 个 环境 配置 文件 
environment.py， 添 加 before_all0 和 after_all0 方 法 ， 
这 两 个 方法 分 别 在 feature 执 行 前 和 结束 后 运行 。 





from selenium import webdriver 


def before all(context): 
context.driver - webdriver.Chrome() 


def after_all(context): 
context.driver.quit() 


10.1.2.3 +47 feature 


现在 可 以 开始 使 用 Behave 执 行 feature 文 件 了 。 
操作 非常 简单 ， 从 命令 行 中 进入 我 们 之 前 创建 的 
bdd 文 件 夹 目录 下 ， 然 后 执行 “behave” 命 令 。 


Doe 行 bdd 文 件 夹 下 的 所 有 feature 文 
件 ， 通 过 前 面 的 step 定 义 和 环 境 配 置信 息 来 运行 相 
应 的 scenario。 下 图 是 behave 命 令 的 执行 结果 。 





C:\Windows\System32\cmd.exe 


c:\setests\chapter10\bdd>behave 
Feature: I want to search for ater Rares # features\search.feature:1 


1 feature passed, 0 failed, 0 ski pa 
voccs passed, 0 fai ed, 0 k n 
ps pas ^m 0 failed, 0 Tpl, £3 a 
- ch 00 








Behave 显 示 3 个 级 别 的 结果 ， 即 feature、 
scenario 和 step 各 级 别 明 过 和 失败 的 数量 。 


10.1.2.4 f FH EZ 


有 时 我 们 可 能 想 用 同样 的 测试 步 又 、 类 似 数 据 
驱动 测试 来 运行 一 批 已 知 状态 、 执 行 操作 和 期 望 结 
条 的 测试 集合 。 对 于 这 样 的 需求 ， 我 们 可 以 写 出 如 
下 的 场景 大 纲 。 





我 们 用 下 面 步骤 中 所 给 的 例子 重 写 
search.feature 文 件 的 场景 大 纲 ， 这 个 场景 大 纲 根 
据 “Example” 部 分 中 的 数据 ， 像 模板 一 样 工作 。 


C1) 本 例 创 建 了 两 个 检验 搜索 功能 的 例子 : 
根据 “类 别 * 搜 索 和 根据 “特定 产品 名 ” 搜 
索 。“ 上 Example” 部 分 以 表格 形式 给 出 搜索 项 和 预期 
结果 。 











Feature: I want to search for products 


Scenario Outline: Search 
Given I am on home page 
when I search for <term> 
then I should see results <search_count> in search 
results 


Examples: By category 


| term | search_count | 
|Phones | 2 | 
[Bags | 7 | 


Examples: By product name 
| term | search count | 
| Madison earbuds | 3 | 





(2) 修改 search_steps.py 文 件 以 匹配 上 面 的 
step。 





from behave import * 


@given('I am on home page') 
def step i am on home page(context): 
context.driver.get("http://demo.magentocommerce.com 


/") 


@when('I search for {text}') 
def step i search for(context, text): 

search field = context.driver.find element by name( 
"q") 

search field.clear() 


# enter search keyword and submit 
search field.send keys(text) 
search field.submit() 


@then('I should see results {text} in search results') 
def step i should see results(context, text): 
products = context.driver. \ 


find_elements_by_xpath("//h2[@class='product-nam 
e']/a") 
# check count of products shown in results 
assert len(products) >= int(text) 





“44h 47 featurell}, BehaveixHXsearch.feature X 
件 中 “Example” 部 分 数据 的 行 数 并 上 自动 循环 执行 场 
景 大 纲 。 它 将 “Example” 中 的 数据 传递 给 scenario 中 
的 step， 然 后 执行 相应 step 定 义 中 的 命令 。 下 图 是 
Behave 执 行 修改 后 的 feature 文 件 的 结果 ， 并 打印 出 
了 feature 上 运行 的 所 有 组 合 信 息 。 


Behave 也 文 持 用 命令 行 选项 -junit 生 成 
junit 格 式 的 报告 。 





C:\Users\amitr\Desktop\setests_final\bdd>behave 
Feature: 


Scenario Outline: Search 
Given I am on home page 
When I search for Phones 
Then I should see results 2 in search results 


Scenario Outline: Search 
Given I am on home page 
When I search for Bags 
Then I should see results 7 in search results 

Scenario Outline: Search 
Given I am on home page 
When I search for Madison earbuds 
Then I should see results 3 in search results 


1 feature passed, 0 failed, 0 skipped 

3 scenarios passed, 0 failed, 0 skipped 

9 steps passed, 0 failed, 0 skipped, 0 undefined 
Took 0m14.539s 


C:\Users\amitr\Desktop\setests_final\bdd> 


I want to search for products # features\search. feature: 1 


features\search.feature:3 
steps\search_steps.py:4 
steps\search_steps.py:9 
steps\search_steps.py:18 


features\search.feature:3 
steps\search_steps.py:4 
steps\search_steps.py:9 
steps\search_steps.py:18 


features\search. feature:3 
steps\search_steps.py:4 
steps\search_steps.py:9 
steps\search_steps.py:18 





10.2 ”持续 集成 Jenkins 


Jenkins 是 Java 编 写 的 流行 的 持续 集成 CI) Ak 
务 ， 起 源 于 Hudson 项 目 。Jenkins 和 Hudson 功 能 相 
似 o 





Jenkins 文 持 各 种 版 本 的 控制 工具 ， 如 CVS、 
SVN. 、Git、Mercurial、Perforce 和 ClearCase， 而 且 
可 以 执行 用 Apache Ant 或 Java Maven 构 建 的 项 目 。 
同时 ， 它 也 可 以 利用 一 些 择 件 、shell 脚 本 和 
Windows 批 处 理 命令 来 构建 其 他 平台 的 项 目 。 


Jenkins 除 了 构建 软件 功能 外 ， 还 可 以 用 于 搭建 
目 动 化 测试 环境 ， 实 现 Selenium WebDriver 测 试 在 
无 人 值守 的 情况 下 按照 预定 的 时 间 调 上 度 运 行 ， 或 每 
次 代码 变更 提交 有 至 版 本 控制 系统 时 实现 目 动 运行 的 
效果 。 








在 接 下 来 的 部 分 ， 我 们 将 学 习 如 何 搭建 Jenkins 
并 创建 一 个 自由 风格 的 软件 项 目 来 执行 测试 。 


10.2.1 Jenkins Iž% 


为 了 能 够 成 功 使 用 Jenkins 执 行 测试 ， 我 们 需要 
做 一 些 修改 。 我 们 的 目标 是 在 Jenkins 上 按 计划 时 间 
执行 测试 ， 然 后 收集 测试 结果 并 显示 在 Jenkins 
Dashboard 页 面 。 为 了 实现 这 个 目标 ， 我 们 将 重用 
第 2 章 中 创建 的 冒 烟 测 试 。 





我 们 使 用 了 unittest 时 TestSuite Runner 批 量 执行 
测试 ， 并 以 JUnit 报 告 的 格式 输出 测试 结果 。 这 就 要 
有 xmlrunner 的 Python 库 的 文 持 ， 可 以 从 
https://pypi.python.org/pypi/xmlrunner/1.7.43X HX - 

现在 执行 以 下 命令 下 载 和 安装 Xmlrunner。 


pip install xmlrunner 


冒 烟 测试 脚本 smoketests.py 是 通过 TestSuite 
Runner 运 行 homepagetests.py 和 searchtest.py 两 个 脚本 
中 的 测试 的 。 我 们 将 使 用 xmlrunner.XML 
TestRunner 来 运行 冒 烟 测试 并 生成 JUnit 测 试 报告 。 
此 报告 以 XML 格 式 生 成 ， 保 存在 test-reports 子 文件 
夹 中 。 要 使 用 xmlrunner， 需 要 对 smoketest.py 做 些 
改动 ， 如 以 下 代码 的 高 腕 显示 部 分 。 








import unittest 

from xmlrunner import xmlrunner 

from searchtest import SearchProductTest 
from homepagetests import HomePageTest 


# get all tests from SearchProductTest and HomePageTest 
class 

search tests = unittest. TestLoader().loadTestsFromTestC 

ase(SearchProd uctTest) 

home page tests = unittest.TestLoader().loadTestsFromTe 


stCase(HomePag eTest) 


# create a test suite combining search test and home pa 
ge test 

smoke tests - unittest.TestSuite([home page tests, sear 
ch tests]) 


# run the suite 
xmlrunner.XMLTestRunner(verbosity-2, output-'test-repor 
ts').run(smoke tests) 





10.2.2 44% Jenkins 


搭建 Jenkins 相 当 简 单 。 你 可 以 下 载 各 种 平台 的 
Jenkins 包 并 进行 安装 。 在 下 面 的 例子 中 ， 我 们 将 安 
闭 并 局 动 Jenkins， 然 后 创建 一 个 新 的 构建 作业 以 对 
示例 应 用 程序 进行 骨 烟 调试 。 


(1) 下 载 并 安装 Jenkins CI 服务 器 。 我 们 下 载 
的 是 Jenkins Windows 安 装 包 ， 并 在 Windows 7 上 安 


装 Jenkins。 


(2) 从 浏览 器 中 进入 Jenkins Dashboard 页 面 
(默认 情况 下 为 http:// localhost:8080) 。 





(3) 在 Jenkins Dashboard 页 面 上 ， 单 击 新 建 
WH (New Item) 或 创建 新 作业 (create new 
jobs) 链接 ， 创 建 一 个 新 的 Jenkins 作 业 ， 如 下 图 所 
Tie 











€ > Q {5 localhost:8080 


Ht Apps Selenium Agile (7] Symantec Testing C] Apple/iOS Web M Sample VBScripts « ... 


Jenkins 
= New Item Welcome to Jenkins! Please create new jobs to get started. 
& People 


=> Build History 
Manage Jenkins 
2 Manage Jenkins 


Credentials 





(4) 在 项 名 称 〈Item name) 文本 框 中 输入 
Demo_App_Smoke_Test， 然 后 选择 构建 自由 风格 的 


软件 项 目 (Freestyle project) 单 选 按钮 ， 如 下 图 所 


CA search 





Item name Demo App Smoke Test 


© Freestyle project 
This is the central feature of Jenkins. Jenkins will 
build your project, combining any SCM with any 
build system, and this can be even used for 
something other than software build. 


O Maven project 
Build a maven project. Jenkins takes advantage of 


your POM files and drastically reduces the 
configuration. 


© Build multi-configuration project 


Suitable for projects that need a large number of 
different configurations, such as testing on multiple 
environments, platform-specific builds, etc. 


CJ External Job 


This type of job allows you to record the execution 
of a process run outside Jenkins, even on a remote 
machine. This is designed so that you can use 





(5) 单 击 确定 《OK) 按钮 。 以 上 面 指定 名 称 
命名 的 新 作业 就 创建 成 功 了 。 





我 们 可 以 连接 至 各 种 版 本 的 控制 或 源 代 
码 控制 管理 (SCM) 工具 ， 如 SVN、Git、 
Perforce 等 ， 以 存储 源 代码 和 测试 代码 。 然 后 
作为 构建 步 又 的 一 部 分 ， 获 取 最 新 版 本 的 代 
人 码 ， 并 在 Jenkins 中 构建 和 测试 软件 。 但 是 ， 
在 本 示例 中 ， 为 了 保证 过 程 的 简洁 性 ， 我 们 
将 在 执行 Windows 批 处 理 命令 (Execute 
Windows batch command) 构建 步骤 中 将 当前 
文件 夹 下 的 测试 脚本 复制 到 Jenkins 工 作 空间 
下 ， 如 以 下 步骤 中 所 述 。 











(6) 在 构建 CBulid) 部 分 中 ， 单 击 添加 构建 
步骤 (Add build step? ， 然 后 从 下 拉 列 表 中 选择 执 
行 Windows 批 处 理 命 令 (Execute Windows batch 
command) 选项 ， 如 下 图 所 示 。 


Build 
Add build step v 


| Execute Python script 
Execute Windows batch command 
Execute shell 
Invoke Ant 


Invoke top-level Maven targets 


(7) EMS (Command) 文本 框 中 输入 以 下 
命令 ， 如 下 图 所 示 。 在 不 同 的 电脑 上 路 径 可 能 会 有 
所 不 同 。 这 个 命令 将 冒 烟 测 试 的 Python 脚本 文件 复 
制 到 Jenkins 工 作 空间 下 并 执行 smoketest.py。 


copy c:\setests\chapter10\smoketests\*.py 
python smoketest.py 


Build 





Execute Windows batch command 


Command — 


人 





(8) 我们 在 前 面 已 经 配置 了 Smoketest.py 以 生 
成 JUnit 格 式 的 测试 结果 ， 并 将 测试 结果 显示 在 
Jenkins Dashboard 页 面 。 要 在 Jenkins 中 集成 这 些 报 
告 ， 先 单 击 添加 构建 后 操作 (Add post-build 
action〉， 然 后 选择 发 布 JUnit 测 试 结果 报告 
(Publish JUnit test result report) 选项， 如 下 图 所 
Ze 








Aggregate downstream test results 
Archive the artifacts 

Build other projects 

Publish JUnit test result report 

Publish Javadoc 

Record fingerprints of files to track usage 


| E-mail Notification 


Add post-build action v 


(9) 在 构建 后 操作 CPost-build Actions) 部 分 
中 ， 在 测试 报告 XML (Test report XMLs) 文本 框 
中 添加 test-reports/ *.xml， 如 下 图 所 示 。Jenkins 每 
次 运行 测试 的 时 候 ， 它 将 从 test-reports 子 文件 夹 中 
AMAZE o 


Post-build Actions 


Publish JUnit test result report 


Test report XMLs a 
lesl-r epar ls/*.xinl 


Fileset ‘includes’ setting that specifies the generated raw XML report files, such as ‘myproject/t 





Retan long standard output/error 


(10) 看 想 按 计 划 时 间 上 自动 执行 测试 ， 在 构建 
fit Cas (Build Triggers) 部 分 选择 定期 构建 (Build 
periodically) ， 并 在 计划 〈Schedule) 文本 框 中 输 
入 如 下 图 所 示 数 据 。 那 么 ， 每 天 22 点 构建 过 程 将 目 
动 触及 ， 作 为 无 人 值守 构建 过 程 的 一 部 分 ，Jenkins 
也 将 自动 执行 测试 ， 这 样 第 二 天 早上 当 你 到 达 办 公 
*& II ESTE 3G BY DA SU SAT Za RS o 





Build Triggers 
Build after other projects zre built 
* Build periodically 


Schedule 


022*** 


(11) 单 击 保存 按钮 你 存 作 业 配 置 。Jenkins 将 


会 显示 新 创建 的 作业 项 目 页 面 。 


(12) 现在 可 以 来 检验 一 下 所 有 的 配置 项 是 否 
设置 好 ， 测 试 是 否 能 成 功 执行 。 单 击 开始 构建 


(Build Now) 链接 手动 运行 该 作业 ， 如 下 图 所 
不 。 


Jenkins Demo_App_Smoke_Tests 


会 zt Project Demo_App_Smoke_Tests 
人 A Status 

- Changes 

lien] Workspace 


Build Now 





= Workspace 
G Delete Project 
Config | 
onfigure 
2 | PF Recent Changes 
Build History (trend) = ] 





FJ ess for all Ej RSS for failures Permalinks 








(13) 在 构建 历史 (Build History) 部 分 中 可 
以 查看 构建 的 运行 状态 ， 如 下 图 所 示 。 


Build History (trend) = 
#4 13-Jul-2014 22:40:57 
i, Am m o 


RSS for all RSS for failures 








(14) 单 击 构建 历史 (Build History) 部 分 中 
正在 运行 的 项 目 ， 将 打开 如 下 图 所 示 的 页 面 。 








ZT Build #4 (13-Jul-2014 22:40:57) 





zu No changes. 
t= 





(15) 除了 Jenkins 页 面 上 的 执行 状态 和 进度 
条 ， 还 可 以 通过 打开 控制 人 台 输 出 〈Console 
Output) RMR RTT ae. RASA B S T 
输出 信息 的 “控制 台 输 出 * 页 面 。 





ys 
rA N 





(J Console Output 


Started by user anony 
Building in workspace C:\Program Files (x86) \Jenkins\workspace\Demo App Smoke Test 1 





[Demo App Smoke Test 1] 


Lous 





$ cmd /c call C:\Windows\TEMP\hudson4452624957 176027.bat 


C:\Program Files (x86) \Jenkins\workspace\Demo App Smoke Test 1»copy C:\Users\amitr\Desktop\Mrunmayee\Final 
\setests final\smoketests\*py 
C:\Users\amitr\Desktop\Mrunmayee\Final\setests final\smoketests\homepagetests.py 


C 
C 
3 file(s) 


C:\Program Files 
Build was aborted 


:\Users\amitr\Desktop\Mrunmayee\Final\setests final\smoketests\searchtests.py 
:\Users\amitr\Desktop\Mrunmayee\Final\setests_ final\smoketests\smoketests.py 


copied. 


Aborted by anonymous 
Recording test results 


ERROR: Publisher hudson.tasks.junit.JUn 


hudson.AbortException: 


at hudson. 
at hudson. 
at hudson. 
at hudson. 
at hudson. 
at hudson. 
at hudson. 
at hudson. 


at hudson.tasks.BuildStepMonitor$1.perform(BuildStepMonitor.java:20) 

at hudson.model.AbstractBuildSAbstractBuildExecution.perform(AbstractBuild.java:770) 

at hudson.model.AbstractBuildSAbstractBuildExecution.performAllBuildSteps (AbstractBuild.java 
at hudson.model.BuildSBuildExecution.post2 (Build.java:183) 


at hudson 


tasks. 
tasks. 


No test report files were foi 


(x86) \Jenkins\workspace\Demo App Smoke Test 1»python smoketests.py 






rer aborted due to exception 
Configuration error? 
junit.JUnitParserSParseResultCallable.invoke(JUnitParser.java:1 
junit.JUnitParserSParseResultCallable.invoke(JUnitParser.java:9 


FilePath.act(FilePath.java:981) 
FilePath.act (FilePath.java:959) 


tasks. 
tasks. 
tasks. 
tasks. 


.model 


junit.JUnitParser.parseResult (JUnitParser.java:89) 
junit.JUnitResultArchiver.pa-zse(JUnitResultArchiver.java:1 
junit.JUnitResultArchiver.pe-form(JUnitResultArchiver.java:138) 
BuildStepCompatibilityLayer.perform(BuildStepCompatibilityLayer.java:74) 





.AbstractBuildSAbstractBuildExecution.post (AbstractBuild.java:683) 


:734) 


at hudson.model.Run.execute (Run. java:1784) 
at hudson.model.FreeStyleBuild.run(FreeStyleBuild.java:43) 
at hudson.model.ResourceController.execute (ResourceController.java:89) 
at hudson.model.Executor.run(Executor.java:2410) 
Finished: ABORTED 


(16) 一 旦 Jenkins 完 成 构建 过 程 
一 个 类 似 于 下 一 个 截图 所 示 的 构建 页 


» WAY AA BI 
面 。 


(17) Jenkins 通 过 读 取 unittest 框 架 生 成 的 测试 


结果 文件 ， 在 页 面 上 显示 测试 结果 和 
标 。 单 击 构建 页 面 上 的 测试 结果 (Te 
接 可 以 查看 Jenkins 保 存 的 测试 结果 。 


(180 我 们 之 前 配置 的 测试 结 


其 他 各 项 指 


st Results) 链 


以 JUnit 格 式 生 


成 。 当 单 击 测试 结果 (Test Results) AY, Jenkins 
会 显示 JUnit 测 试 结果 ， 如 下 图 所 示 ， 显 示 测 试 结果 
摘要 ， 其 中 失败 的 测试 会 高 之 显示 。 


Test Result 


0 failures (-1 


4 tests (+0) 


All Tests 

Package Duration Fail (diff) Skip (diff) Pass (diff) Total (diff) 
homepagetests 1 min 22 sec 0 -1 0 3| +1 3 
searchtest 37 sec 0 0 1 1 


(19) 我 们 也 可 以 单 击 Package 名 字 的 链接 来 
查看 各 个 测试 的 详细 结果 信息 ， 如 下 图 所 示 。 


Test Result : HomePageTest 


D failures inn) 


3 tests (+0) 
ook m n 2 2 sec 


(add description 
All Tests 

Test name Duration Status 

test language. option 25 sec Passed 

test search field 28 sec Passed 


test shopping cart empty message 28 sec Passed 


Jenkins 还 会 以 下 图 所 示 的 格式 在 Dashboard 主 
页 上 显示 所 有 构建 作业 的 最 终 状态 信息 。 





i ENABLE AUTO REFRESH 
证 New Item 





[Wadd description 
All = 
& People s VW Name | Last Success Last Failure Last Duration 
lay Bull Histo - ix Demo App Smoke Tests 





5 min 30 sec - #4 N/A 2 min 20 sec © 
a Manage Jenkins 
Tc SML 





Legend Ej ass for all RSS for failures RSS for 





ust latest builds 





10.3 3: 5 [E] Bj 


在 本 章 中 ， 我 们 学 习 了 如 何 将 Selenium 与 
BDD (Behave) 和 CI (Jenkins) 集成 。 实 现 了 将 
Selenium WebDriver API 与 Behave 和 集成， 并 通过 编 
写 feature 和 step 定 义 文件 来 执行 自动 化 验收 测试 。 





通过 搭建 Jenkins 运 行 Selenium WebDriver 测 
试 ， 从 而 实现 每 晚 在 无 人 值守 的 情况 下 上 自动 构建 程 
序 和 执行 测试 。Jenkins 提 供 了 一 个 易于 搭建 的 平 
人 台 ， 来 对 接 各 种 程序 开发 平台 的 构建 和 运行 测试 作 
业 。 











到 目前 为 止 ， 我 们 已 经 完成 了 了 Python Selenium 
WebDriver 的 学 习 之 旅 。 我 们 主要 学 习 了 使 用 
Selenium WebDriver 进 行 Web 应 用 程序 在 浏览 右 中 
的 交互 测试 和 目 动 化 测试 的 基本 知识 点 ， 运 用 这 些 
知识 点 ， 我 们 残 可 以 构建 目 己 的 上 自动 化 测试 框架 














欢迎 来 到 异步 社区 ! 


异步 社区 的 来 历 


异步 社区 (www.epubit.com.cn) 是 人 民 邮 电 出 版 
社 旗下 IT 专业 图 书 旗舰 社区 ， 于 2015 年 8 月 上 线 运 
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FEDS LX ARIE A RAR FEL AL 2048 EIT 7 
业 优 质 出 版 资源 和 编辑 策划 团队 ， 打 造 传统 出 版 与 
电子 出 版 和 自 出 版 结合 、 纸 质 书 与 电子 书 结合 、 传 
统 印 刷 与 POD 按 需 印 刷 结合 的 出 版 平 台 ， 拥 供 最 新 
技术 资讯 ， 为 作者 和 读者 打造 交流 互动 的 平台 。 
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免费 电子 书 


Free eBook 








我 要 写 书 


Write for Us 











python 机 器 学 习 一 一 预 OHA: ERRE — 机 器 学 习 项 目 开发 实战 — CIDHECUS : ite 
morem eee | 的 Python 学 习 法 近期 活动 





AX BAA 4T A ? 


购买 图 书 


我 们 出 版 的 图 书 涵盖 主流 全 技术 ， 在 编程 语 
言 、Web 搁 术 、 数 据 科 学 等 领域 有 众多 经 典 畅销 图 
书 。 社 区 现 已 上 线 图 书 1000 余 种 ， 电 子 书 400 多 
种 ， 部 分 新 书 实现 纸 书 、 电 子 书 同步 出 版 。 我 们 还 
会 定期 及 布 新 书 书 讯 。 





社区 内 提供 随 书 附 赠 的 资源 ， 如 书 中 的 案例 或 
程序 源 代码 。 





为 外 ， 社 区 还 提供 了 大 量 的 免费 电子 书 ， 只 要 
注册 成 为 社区 用 户 融 可 以 免费 下 载 。 


与 作 详 痢 互 动 





很 多 图 书 的 作 译 者 已 经 入 驻 社区 ， 您 可 以 关注 
他 们 ， 咨 询 技术 问题 ， 可 以 阅读 不 断 更 新 的 技术 文 
革 ， 咏 作 详 者 和 编辑 畅 聊 好 书 背 后 有 趣 的 故事 ， 还 
可 以 参与 社区 的 作者 访谈 栏目 ， 疝 您 关注 的 作者 所 
出 采访 题目 。 


灵活 优惠 的 购书 


您 可 以 方便 地 下 单 购买 纸 质 图 书 或 电子 图 书 ， 
纸 质 图 书 直 接 从 人 民 邮 电 出 版 社 书库 发 贷 ， 电 子 书 
提供 多 种 阅读 格式 。 


对 于 重 磅 新 书 ， 社 区 提供 预 售 和 新 书 首 发 服 
务 ， 用 户 可 以 第 一 时 间 买 到 心仪 的 新 书 。 

用 户 帐 户 中 的 积分 可 以 用 于 购书 优惠 。100 积 
积分 数值 ， 即 可 扣 减 相应 金额 。 


特别 优惠 








购买 本 电子 书 的 读者 专 享 异 步 社区 优惠 券 。 使 用 方法 : 注册 成 为 
社区 用 户 ， 在 下 单 购书 时 输入 “57AWG”， 然 后 点 击 “ 使 用 优惠 码 ”， 即 
可 至 受 电子 书 8 折 优惠 (本 优惠 券 只 可 使 用 一 次 ) 。 





纸 电 图 书 组 合 购买 


社区 独家 提供 纸 质 图 书 和 电子 书 组 合 购 买方 
陈 ， 价 格 优 惠 ， 一 次 购买 ， 多 种 阅读 选择 。 


| Wireshark 网 络 分 析 的 艺术 SMES 
作者 4100-1 LinPeiman & 
na . Site 
7H : 计算 机 科学 > 安全 与 加 密 > Rises 
上 海 


Wireshark S GR GIOI SIR. c ERES. EWERAN. RS : 
E MUGIDNISOERWiresharkf£am 7) 5, 1.0Kíz 39d 
, 本 书 措 和 远 的 网 站 刀 来 自 真实 场景 ERAS. HMNRBT SR WE 
Wireshark ve à " n 
网 络 分 类 的 区 市 GL "TATE > 5.6K $2 “47 全 s GS 
(Wireshark 83 18 $5 ffr 8t 13 2. 88 


MS mis 
M) 80 (Wireshark BERRA 
术 》 作 者 








am Qe 


推 
" 
SEE ¥45.00- ¥ 31.50 (7 91) || BF ¥ 25.06 JI RM 450 ES 
RAB 


"EM IM ze 
d en : 75.60 E !'08 BEC 9 














目录 meo DO 出 版 信息 
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提交 勘误 





您 可 以 在 图 书页 面 下 方 提 区 勘误 ， 每 条 勘误 被 
确认 后 可 以 获得 100 积 分 。 热 心 勘误 的 读者 还 有 机 
会 参与 书稿 的 审 校 和 翻译 工作 。 

EE 

社区 提供 基于 Markdown 的 写作 环境 ， 嘉 欢 写 

作 的 您 可 以 在 此 一 试 导 手 ， 在 社区 里 分 享 您 的 技术 


心得 和 读书 体会 ， 更 可 以 体验 目 出 版 的 乐趣 ， 轻 松 
实现 出 版 的 梦想 。 











如 果 成 为 社区 认证 作 译 者 ， 还 可 以 圣 受 寞 步 社 
区 提供 的 作者 专 圣 特色 服务 。 
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费 获 赠 大 会 门票 。 





MARL 


扫描 任意 二 维 码 都 能 找到 我 们 : 


i lik 








微 信服 务 号 











QQ 和 群 : 436746675 


社区 网 址 : www.epubit.com.cn 





官方 微 信 : 异步 社区 


EJM: @ 人 邮 异 步 社区 ，@ 人 民 邮 电 出 版 
社 -信息 技术 分 社 


FS Ain ‘ZF Vi]: contact@epubit.com.cn 


